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PREFACE AND READER'S GUIDE 



The audience for this manual is engineers who design products for signal processing. 



The purpose of this manual is to familiarize you with the features of this Compiler 
such that with a few hours of reading and practice you can feel comfortable using it 
to design electrical filters and other applications, and generate 2920 programs for 
them. 



The Compiler can be used to generate 2920 assembly language code for a wide 
variety of signal processing applications. In the present manual, electrical filters 
are a central focus of discussion. A brief review of digital and analog filter 
design appears in Appendix H. The formulas used by the Compiler for computing 
the frequency responses of the filter appear in Appendix I. 

The primary purpose of this Compiler is to make it easy to specify the frequency 
response of a desired digital filter and implement the filter in AS2920 assembly 
language code. It enables you to 

• specify and modify design parameters, e.g., set sampling rate (Chapter 3), place 
poles and zeros at chosen S-plane or Z-plane coordinates (Chapter 4), and set 
error bounds on gain (Chapter 5); 

• see immediately on a graph or list the frequency or time response of existing 
poles and zeros at specified frequencies, or display any design parameter 
(Chapters 5, 6); 

• generate, store, and review AS2920 assembly language code for each filter or 
stage, subject to constraints you specify on error functions and program size, 
after response appears appropriate to your design (Chapter 7); 

• use diskette files as scratchpads to store, review, modify, and retrieve files of 
parameters, code, or commentary (Chapter 8); 

• create your own name for command sequences (macros) to facilitate your 
interactive design sessions and unattended test sessions (Chapters 9 through 11). 

This feature greatly multiplies the power of the Compiler because it enables you 
to use additional transforms, constraints, and procedures in any of your subse- 
quent design sessions, after defining them once. 

The minimum hardware configuration for the SPAC20 Compiler is as follows: 

• INTELLEC or INTELLEC-II with 64K bytes of random access memory 
(RAM), 

• Teletypewriter, CRT, or equivalent for console input and output, 

• One diskette drive unit, single or double density. 



If a line printer is available, it can be used for large-volume or hard-copy output, 
including graphics. If the system includes an iSBC-310 math board the SPAC20 
module will use it to speed computations significantly. 

The SPAC20 Compiler is designed to be used in conjunction with other Intel 
products, most clearly the AS2920 Assembler and SM2920 Simulator. Further, the 
Compiler uses the ISIS-II keyboard and disk input/output functions. You may wish 
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to refer to other documents containing valuable information about the supervisor, 
the Intellec system, and the other software (e.g., the Editor) used on it. These 
include: 

INTELLEC Operator's Manual 9800129 

INTELLEC/DOS Diskette 

Operating System Operator's Manual 9800206 

ISIS-II System User 's Guide 9800306 

2920 Assem bly Language Man ual 9800987 

2920 Simulator User's Guide ' 9800988 

ISIS-II CREDIT User's Guide 

(CR T-Based Text Editor) 9800902 

Intellec Microcomputer Development 

System Hardware Reference Manual 9800 1 32 

iSBC-310 High Speed Mathematics 

Unit Hardware Reference Manual 9800410 

Digital signal processing is an extensive subject. This manual assumes the reader has 
at least a rudimentary knowledge of it, and does not attempt more than a review at 
that level. A more detailed understanding can be obtained through the study of texts 
written for that purpose, e.g., 

Digital Signal Processing 

by A. V. Oppenheim and R. W. Schafer, Prentice Hall, Inc. 1975 

Digital Signal Processing 

by Abraham Peled and Bede Liu, John Wiley, 1976 

Theory and Applica tion of Digital Signal Processing 
by L. R. Rabiner and B. Gold, Prentice Hall, Inc. 1975 

After first scanning Chapter 1 of this manual, you might next scan areas of interest 
among Chapters 3 through 8. Although Chapter 2 is necessary for a full definition 
and understanding of the SPAC20 Compiler, its technical detail can perhaps be 
better absorbed later, after you build some general familiarity with how you might 
use the Compiler commands to achieve your purposes. It is placed second because its 
contents are later taken for granted. This may not trouble you much if you've used 
compilers before or if you use the index to fill in the gaps as you go. Appendices A, 
B, and E also help tie things together by supplying explanations, tables, and charts 
about the language. 

Chapters 9 through 11 assume you have mastered the other chapters. Compound 
commands are very powerful and useful, but they might be confusing in your first 
pass through the book. 

This Compiler differs from many others in that it is to be used in the process of 
interactive design, rather than after the design is complete. In addition, it produces 
partial rather than complete code. Further editing of its output code is required by 
considerations of analog-to-digital conversion, signal scaling, and code compaction, 
e.g., the merging of instructions for a pole with those for a zero (see Appendices G 
and J). 

There is a certain symmetry about the commands which may help you learn and 
remember them. You can display nearly any object (e.g., one or all poles, gain, 
bounds) by typing its name followed by a carriage return. You can change nearly 
any object by typing its name followed by an equal sign and the new desired value. 



The commands fall into functional categories, and their syntax is relatively uniform. 
For example, nearly all the file commands use the same set of objects or modifiers. 
Similarly, all the pole and zero commands use one set of objects or modifiers, and 
all the graph commands use one such set. This is most clearly shown by the syntax 
charts in Appendix E. 

The syntax discussion in Chapter 2 is deliberately simplified and incomplete, 
because the full range of expressions is rarely relevant until you have mastered the 
simple commands, and moved on to learn the power of compound commands and 
macros in Chapters 9 through 1 1 . 

The Compiler's matched-Z transform is not always the function of choice for map- 
ping S-plane poles and zeros to the Z-plane, although one of its advantages is easy 
movement from S to Z or Z to S-planes. Once macros are understood, it becomes a 
simple matter to create alternate transform(s), such as bilinear, and thereafter use 
them as desired. The discussions prior to Chapter 9 assume the use of the built-in 
matched-Z transform without further comment. The review in Appendix H contains 
a discussion of various other transforms. 



Notation of this Manual 

Most of the constructs and commands in this book are set forth using syntax charts, 
a pictorial representation of how the building blocks of the SPAC20 commands are 
legally combined. 

These charts always begin at the left with an arrow that leads to an elliptical box or a 
set of such boxes, indicating necessary or optional parts of the construct. The charts 
always end with a single arrow off to the right. You create legal constructs by 
following the arrows within these graphs, looping back to repeat some element only 
if there is an arrowed line showing that you may do so. When a choice must be made 
among several options, a single arrow will lead to a vertical bar, from which multiple 
arrows permit you to go along the path containing the option you want. Here are 
some examples: 



-► ( digit ) — L-| 



.q-^^^TqX 



unsigned decimal constant 121533-06 

where digit means any one of the set 0,1,2,3,4,5,6,7,8,9. 

This says that to construct an unsigned decimal constant for use in some command, 
you must start with either a digit or a decimal point. If you start with a digit, you 
may continue to place digits after it (up to the limit of 31 digits), or you may choose 
the other branch at any time, placing a decimal point next, or you may quit, exiting 
the chart at the right. As you exit the chart you have the choice of appending a D 
after your digits, explicitly indicating this is a decimal number rather than a binary 
or hexadecimal number. This is optional because decimal is assumed whenever no 
suffix is present. 



If you chose to insert a decimal point, you must now enter at least one digit before 
exiting. You may add as many as 31 (less the number of digits already entered), but 
you may not enter another decimal point — the arrowed lines offer no path to it. 



-C hex-digit j- 



o 



-Gk 



— ( * J-^Q dec digit^ 1 — J*~Q_ hex digit") *-*■ 



unsigned hexadecimal constant 



121533-06 



where hex-digit is any one of the set 0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F. Dec-digit, 
like digit above, includes only the first ten of these. 



This chart shows that to create a hexadecimal constant you may begin with a decimal 
point or a hex-digit. If you start with a hex-digit, you may continue appending hex- 
digits or place a decimal point next, after which you may again append hex-digits 
until you choose to exit the chart on the right, where you are required to append the 
H suffix labeling this a hexadecimal constant. 



If your constant is a fraction only, i.e., has no digit to the left of the decimal point, 
then the digit immediately after the decimal point must be a decimal digit, i.e., not a 
letter. Once you have begun with "point dec-digit", succeeding digits may be any 
legal hexrdigit. Exiting the chart is as above. The reasons for the restrictions em- 
bodied in the chart are explained in Chapter 2. 



Syntax charts often contain the names of other syntax charts, indicated by lower- 
case words as opposed to the capitals used for keywords. The charts are combined 
simply by substituting the full chart of the named item in place of the name. As an 
example, the chart for "numeric constant" includes by reference the two charts 
above: 




~f system constant \-*~ 

-funsigned dec-constant )-► 



Q 



unsigned hex-constant 



>~ 



c 



unsigned bin-constant 



>J 



numeric constant 



121533-06 
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To give one command example, the remove command for poles and zeros has the 
following chart: 



- < P0LE > 

^REMOVE J-»» — ».(" 



ZERO 



> 



•^■f partition 



>l" 



PZ 



The REMOVE Command for Poles and Zeros 



121533-18 



indicating you must enter the word REMOVE and one of the three object words 
POLE, ZERO, or PZ. With that, you're done unless you wish to use a partition, 
which is indicated to be optional by being off the required exit line. (The chart for 
partition appears in Chapter 2. This command is explained in Chapter 4.) 
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CHAPTER 1 
INTRODUCTION 



Concepts of Filter Design 



Designing a filter involves choosing operations to perform on input signals in order 
to produce modified signals as output. These operations are usually linear. The 
theory relating continuous analog filters to sampled digital filters is reviewed in 
Appendix H. Digital filters are covered in great detail by the books on digital signal 
theory in the bibliography. 

Filters are usually designed to achieve certain gain and phase characteristics. These 
can be viewed as implementing a mathematical transfer function, whose factors 
relate directly to the desired attributes. Factors which represent complex frequencies 
at which the gain is zero are called the zeros of this filter. Factors representing 
frequencies at which the gain grows indeterminately large are called the poles of the 
filter. 



These poles and zeros are complex numbers of the form a + bj, where j = V-T. 
Thus a filter's poles and zeros can be specified on a complex-valued graph, such as 
the S-plane or the Z-plane. 



The desired output amplitude and phase can now be approached in an interactive 
design session by placing poles and zeros in the S-plane (for continuous filters) or the 
Z-plane (for sampled filters), and viewing the resultant output. Moving these poles 
and zeros can then change that output to more closely approximate what is needed. 
The compiler capabilities facilitate this interactive process of specification, 
modification, and review by providing simple commands and graphs for these 
functions. 



Introduction to the Compiler 

The SPAC20 Signal Processing Applications Compiler accepts high-level (English- 
like) language input and produces 2920 Assembly language code. The Compiler is 
also a filter design aid which permits substantial interactive manipulation of a wide 
variety of parameters and constraints, both in design of filter stages and in opti- 
mization of code size and/or error limits. 

The two principal functions of the SPAC20 Compiler are: 

1 . to make it easy for you to specify, alter, and review design parameters for your 
signal processing application, and 

2. to save your writing all the detailed steps required to implement the necessary 
functions in assembly language code. 



One example is specifying the frequency response of a desired digital filter, checking 
gain, phase, or other aspects and changing parameters as needed. You then 
implement the filter by issuing one CODE command for each pole or zero, thus 
generating the AS2920 code. 



1-1 



Introduction 



SPAC20 Compiler 



NOTE 

The specific functions and features of the Intel 2920 processor are described 
in the data sheet for that device. The AS2920 Assembler converts the user- 
edited output of this Compiler into object code that will directly run on an 
Intel 2920 processor. The assembler is described in the manual entitled 2920 
Assembly Language Manual , order number 9800987. 

Once a program has been converted to object code, it can be tested using 
another Intel product, called the SM2920 Simulator. This product is 
described in the 2920 Simulator User's Guide, order number 9800988. 
Many features of this Compiler show a family resemblance to the 
Simulator, and to Intel's In-Circuit-Emulator-86 (ICE-86). 

This resemblance includes the use of compound commands, which are 
featured in the Intel product which handles multiple In-Circuit-Emulators, 
called multi-ICE. It is described in manual number 9800762 entitled Mutli- 
ICE Operating Instructions for ISIS-II Users. 



The Help Messages 



-Q_ help *y 



(36 help items are 

displayed when HELP 

is entered; see Appendix A) 



*f help item \ 

-CZ 



HELP Command 



121533-27 



The SPAC20 Compiler has a help message facility, which can inform or remind you 
of the form, function, or interrelationships of compiler keywords, concepts, and 
commands. These messages can be requested any time no other command is being 
executed, i.e., whenever the compiler has issued its prompt character (asterisk): 



*HELP 



Typing in this word will cause an index of all help messages available to be displayed 
on the console. If you enter the following sequence 

*LIST : LP: 
*HELP* 

then all the messages will be printed out on the line printer. (They appear in 
Appendix A in this form.) 

You can get the help message for only specific items by typing the item name after 
HELP, e.g. 

* HELP DEFINE 

will cause the help message on the define command to be displayed. 

Requesting help on scales or normalization or bounds will get you a description of 
certain system variables and how to access them, e.g., FSCALE, GREF, BOUNDS, 
etc. Similarly, requesting help on change or display can remind you of how the 
different forms or references can be used. 
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Probable Sequence of Use 

1 . Define or include symbolic constants for easy use; define sample interval TS; 

2. a. define poles and zeros, move or remove them as desired in TS plane, that is, 

the sampled S-plane (see below); implement desired filter as if continuous; 

b. define poles and zeros, move or remove as desired in Z-plane to implement 
desired filter; 

c. use a macro, e.g., Chebyshev or Bilinear, to locate poles and zeros for a 
particular filter; 

3. set bounds to be able to determine closeness to desired spec and to guide code 
generation; look at MSQE , GERROR, etc. to see closeness; 

4. graph filter response and other filter behavior; 

5. if the filter is not yet "good enough", return to step 2; 

6. save current poles and zeros in diskette file via put or append command; 

7. code the (next) pole or zero with either gain bound constraint or other 
constraint; examine resulting filter responses; 

8. if not satisfactory, restore poles and zeros and return to step 7 to use a different 
constraint, or return to step 1 to begin anew; 

9. if satisfactory, put or append code; 

10. if there is another pole or zero, return to step 7 for the next one; 

1 1 . if all poles and zeros are coded, you now have final filter; 

12. determine scaling; for example, save coded poles and zeros; delete all but the 
first n; MAGAIN reveals scale for (n+l) th stage; append comment for code 
file; restore earlier poles and zeros; repeat. Alternatively, can delete poles or 
zeros in reverse order one by one; 

13. as needed, generate code for other functions, using code, macro, and compound 
commands, e.g., sawtooth wave generator, and append to code file; 

14. exit; edit code file to insert additional scaling if needed (per code comments), 
add I/O, end statement; assemble with AS2920; simulate with SM2920; 
program the EPROM in the 2920 chip. 



Defining a Filter 

You can define a filter by specifying the location of poles and zeros in the S-plane or 
the Z-plane corresponding to a sample rate which you supply. Complex poles always 
occur as conjugate pole pairs so that the filter is realizable. Poles and zeros can be 
created, moved, or removed. Continuous poles and zeros in the S-plane describe 
portions of the total filter which will be implemented outside of the 2920 chip. 

Poles and zeros can be specified in the S-plane and then designated as sampled. 
During calculation, these poles and zeros are mapped to the Z-plane using the 
matched-Z transform, i.e., a pole or zero at x+jy on the S-plane is transferred to a 
pole or zero at e 2nTS ( x+ Jy) on the Z-plane, where TS represents the sample interval in 
the sampled S-plane. In polar coordinates, this Z-plane location is (e 2nTSx , 2nTSy) 

This transform allows an analog design engineer who is not already familiar with 
digital filter theory to work in more familiar territory. For low frequencies, relative 
to the sample rate, it does offer a relatively faithful translation of analog filters to 
digital. However, the matched-Z transform is not ideal in many cases, and therefore 
some users prefer to work directly in the Z-plane. 
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Displaying the Response 



You can examine the frequency response of your filter as you manipulate the 
position of poles and zeros. The gain, phase, group delay, and time responses can be 
graphed or listed. You can specify the frequency range of interest for these outputs. 
While emphasis is placed on the gain versus frequency response of the filter, you can 
take advantage of the compound command capability described in Chapter 9 to use 
the phase, impulse, or step responses. 

The graphs do not require the console device to have any cursor controls; e.g., the 
ability to move the beam directly by pressing a button for up, down, left, or right. 
You specify the X-axis and the Y-axis ranges. The last curve plotted is always 
available for redisplay upon entering the command GRAPH, regardless of the effect 
of intervening commands. It is also possible to superimpose the last curve plotted 
and a new curve, regardless of intervening scale changes. The graphs can be sent to a 
diskette file, or hard copies can be produced on a line printer, since no special cursor 
control characters are assumed. 



Generating Code 

Once the filter responses (e.g., gain, error, phase) look adequate to meet your design 
specifications, you can generate the code for each pole or zero with a single com- 
mand. The Compiler enables you to implement the filter as a cascaded series of first 
and second order stages. You can also generate code to compute independent 
variables of the form Y=C*X or Y=C*X+Y or Y=C*Y, where C is a constant, and 
X and Y are variable names. These are useful for propagation and scaling of the 
digital signal between stages. 

These modules of assembly language code can be accumulated into a file to be used 
as input to the 2920 Assembler. Prior to submitting the code to the Assembler, you 
will need to do some editing to implement the analog-to-digital and digital-to-analog 
functions, and also the above propagation and scaling. (See the ISIS-II or Editor 
manuals for editing instructions.) During this editing it is also possible to compact 
the program by merging the code for a pole with the code for a zero, as described in 
Appendix J. The analog-to-digital and digital-to-analog code can be merged with the 
arithmetic code which implements the filter by appending analog instructions to 
arithmetic/logic instructions: see the AS2920 manual. 

During code generation for one stage of a filter, you may wish to sacrifice numerical 
accuracy in order to get a shorter program. Towards this end, code generation is 
performed subject to constraints which you specify. One such constraint consists of 
the "error" relative to piecewise linear bounds on the gain, in decibels, as a function 
of (log of) frequency. The Compiler then strives to minimize the mean-square devia- 
tion from these bounds. 

Before saving the resulting code into a file, you may wish to interactively adjust the 
number of instructions you have allowed the Compiler to generate, or to adjust the 
error you are willing to tolerate, in order to achieve the shortest program which 
meets your error requirements. You can then save this new code in a file. 



Filing and Retrieving Code or Parameters 

This process of filter specification, display, and adjustment is extremely interactive. 
The file commands have been structured to facilitate the restart of an interrupted 
design or test session. They also make it easy to accumulate, into one or many files, 
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the partial results of specifying parameters or creating code. Parameter files saved 
from an interrupted design session can then be INCLUDEd at a later date, to resume 
that design session with all relevant variables restored to their condition at the time 
the session was interrupted. 

You also have the ability to display any ISIS-II diskette file on the console, or to add 
arbitrary test or other data to the end of existing diskette files. This permits you to 
use disk files as scratch pads, and also to perform simple, low-level editing of files. 
The latter facility can be useful for building final 2920 assembly language files for 
submission to the AS2920 Assembler. The procedure for such submission is 
described briefly in Appendix G (see the Assembler manual for full details.) 

Compound Commands 

This Compiler contains macro and compound command facilities. They enable you 
to extend the language itself by defining your own commands using sequences of the 
simple commands described in Chapters 2 through 8. 

Such macros make it possible, for example, to define an iterative process of moving 
poles and zeros and graphing the resultant response, without having to type all the 
commands during each iteration of that process, or to perform other design or test 
experiments, including code generation and display. Such a macro is interruptible at 
any time by hitting the console ESCape key. Macros can also be used as code 
generators for functions other than filters. Examples of macros which may be useful 
(and also used as models) appear in Chapters 10 and 1 1 . 

Simple Sample Session 

This printout is a complete copy of an interactive session, produced by a LIST 
command (see Chapter 8). 

The macro used in this session is not intended for study at this point. It appears here 
only to illustrate the facility for retrieving macros and the form in which they are 
defined. Shown below is a macro to produce a Chebyshev filter. Macros and 
compound commands are explained in Chapter 9, with numerous examples in 
Chapters 10 and 11. 



*; 13 DEC 79 

* 

*; ISIS-II 2920 SIGNAL PROCESSING APPLICATIONS COMPILER. VI .0 

* 

•HELP ; WHEN IN DOUBT, ASK FOR HELP 

*** Help is available for the following itens. Type HELP followed *** 

*** by the iten nane. Do not type the angle brackets. <For nore *** 

*** information on the help connand* type HELP HELP.) *** 

Filters and Filter Responses: 

DEFINE. <FILTERf RESPONSE >,GREF,H0LD, HOVE , < PQLE*OR*ZERO*L0CAT I0N> , 

<PQ LESSOR *2ERQES>, REMOVE 
Graphi est 

FSCALE, GRAPH, YSCALE 
Code Generation) 

B0UNDS,C00E,<HA*C0HSTRAINT>,<P2*C0NSTRAIHT> 
F i le/D isplay/Conpound Connands: 

<C0MPOUHD*COHHANDS), EVALUATE, EX IT , <F ILE«C0MHANDS >, HELP, NACR0, 

<PATH*NAHE>,URITE 
H i seel laneousi 

< BOOLE AN*EXPR>,< CONST ANT >, <£XPR >, <FUNCT 10N> , < IDENTIFIER), 

<IHTEGER*EXPR>,< MINER ICtCONSTANT),<PRIHARY>,<PZsREF>,<SPAC$REF>, 

<STRIHG>,<SYHBOL),<SYHBOLIC*REF) 
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<F iLTERfRESPQNSE > - One of the following filter responses: 

GhIH Gain in decibels as a function of frequency in Hertz. 
AGAIN Absolute gain as a function of frequency in Hertz. 
PHASE Phase delay in radians as a function of frequency in Hertz 
GROUP Group delay in seconds as a function of frequency in Hertz 
GERROR Signed deviation of GAIN fron the LBOUND and UBOUND 
in decibels as a function of frequency in Hertz. 
See <B0UNDS>. 
IMPULSE Inpulse response as a function of tine in seconds. 
STEP Step response as a function of tine in seconds. 

Each <F ILTER*RESPONSE> can be used as a connand to tabulate the values. 

Each can be graphed. Each except IMPULSE and STEP can be used as a 

function in an expression* e.g. AGAIN<60). 

So* :fuhction>, GRAPH, <PRIMARY>. 



♦DEFINE POLE 1 



-20, 1000 



CREATE A POLE IN CONTINUOUS S-PLANE 



*P2 i LIST ALL POLES AND ZEROES 

POLE 1 * -20.000000,1000.00000, CONTINUOUS 

* 

• GREF ; GREF DETERMINES THE GAIN NORMALIZATION 
GREF = 0.00000000 AT 0.00000000 

* 

*> GREF DEFAULTS TO DECIBELS AT HERTZ. 

* 

•YSCALE ; YSCALE DETERMINES THE VERTICAL GRAPHICS SCALE 

YSCALE » AUTO ) 0.00000000,0.00000000 

* 

*i AUTO MEANS THAT THE VERTICAL RANGE IS AUTOMATICALLY DETERMINED 

* 

• J BY THE MINIMUM AND MAXIMUM VALUES OF THE CURVE BEING PLOTTED. 

*; CURRENTLY THE MINIMUM AND MAXIMUM ARE BOTH 0. 

* 

♦FSCALE = 100, 10000 J ESTABLISHES FREQUENCY RANGE OF INTEREST 

*; WELL, LET'S SEE WHAT THE GAIN LOOKS LIKE FOR OUR ONE POLE FILTER 

•GRAPH GAIN 



GAIM 

23 

25 

21 

18 

15 

12 

9 

5 

2 

-1 

-4 

-8 

-1 1 

-14 

-1? 

-21 

-24 

-2? 

-30 

-33 

-3? 

-40 



DB 1 HZ I AA AAAAAAA A A 

100 150 200 300 400 500 700 1000 1400 2000 3000 5000 



10000 
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* 

*; THE UNITS USED IH GRAPHING GAIN ARE SHOVN IN THE LOWER LEFT. 

*; GAIN IH DECIBELS IS GRAPHED VERSUS FREQUENCY IN HERTZ. 

*i NOTE THAT THE GAIN PEAKS AT ABOUT 1000 HZ. 

♦GAIN ; CAN ALSO TABULATE GAIN VALUES 

GAINdOO. 000000) « 0.087190039 

GAIN(107. 006896) » 0.099910137 

GAIN< 1 14.304760) » 0.114497473 

GAIN( 122.927992) » 0.131230859 

GAIN< 131 . 113403) * 0.130431115 

GAIN<140. 300384) » 0.17246827 

GAIN< ISO. 131088) » 0.19777049 

GAIN< 160. 650619) * 0.22683386 

GAINC171 .90724 > - 0.26023186 

PROCESSING ABORTED 

* 

♦; TABULATION HAS INTERRUPTED WITH THE ESCAPE KEY. 

♦ 

*; ESCAPE KEY CAN ALUAYS BE USED TO ABORT THE COMPILER'S PROCESSING. 

* 

♦HOVE POLE 1 BY 0,-300 ; SHIFT GAIN PEAK DOWN TO 700 HZ 

1 POLES/ZEROES MOVED 

* 

•OGRAPH GAIN ; OVERGRAPH HEM GAIN CURVE 

Q £ T M f A* AAA A A AA A A | 

23 ' + 

20 

17 

13 + ♦ 

10 . ' - + 

7 .-'4.4 

3 — -' ' 44 - 

' ' ' ' ' ' ' ' ' ' ' ' + + +4 - + 

-3 4444444 44+444444444444444 '. 44 

-6 ' . 4 

-10 '.44 

-13 '-44 

-16 '-.4 

-20 ' .4 

-23 

-26 ' .4 

-30 

-33 

-36 '.4 

-40 

-4 3 '-. 

-46 

DB I HZ ! A . . . * *...*...*....*....*....*....* A * ! 

100 ISO 200 300 400 500 700 1000 1400 2000 3000 SOOO 10000 

* 

* 

*i PLUS SIGNS INDICATE OLD CURVE. 

* 

*; UE CAH ALSO EXAMINE THE PHASE RESPONSE. 
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•GRAPH PHASE 

PHASE ' A A A A A A A A. A A A | 

-0.01 ,>......,.,>,,.,, ., ,, , 

-0 16 
-0 31 
-0.46 
-0 60 
-0 75 
-0.90 
-1 .05 
-1 20 
-1 .35 
-1.50 
-1 65 
-1 80 
-1 95 
-2.09 
-2 24 
-2 39 
-2 54 
-2 69 
-2.84 
-2.99 

-3.14 ' '" . 

R AD I HZ I ..... A ... * *...*.. .*....*.. ..*....*....* A * ! 

100 150 200 300 400 500 700 1000 1400 2000 3000 5000 10000 
* 
* 
*; PHASE IS EXPRESSED IN RADIANS. 

*; NOTE THAT THE VERTICAL SCALE RANGES FROM ABOUT -PI TO 0. 

* 

•YSCALE ; DISPLAYS ACTUAL HIN AND HAX VERTICAL VALUES 

YSCALE =■ AUTO i -3. 1375729* -0 . 0083262023 

* 

♦ EVALUATE -PI .* DISPLAYS DECIMAL VALUE OF -PI FOR COMPARISON 

-3 1415927*10**0 

* 

•YSCALE * -PI.PI ; A MORE APPROPRIATE VERTICAL SCALE FOR PHASE 

•GRA PHA ; GRAPH PHASE (ONLY FIRST THREE LETTERS ARE EVER NEEDED) 

PHASE | A A A A A A A A A A A j 

3 : i 

2 34 

2 54 

2 24 

1 34 

1 65 

1.35 

1 05 

75 

45 

15 

-0 15 "»».__ 

-0.45 

-0 75 

-1 05 

-1 35 

-1 65 

-1 94 

-2 24 

-2.54 

-2 84 

-3 14 '" 

t> At\ I U7 | A A AAAAAAA A A | 

100 150 200 300 400 500 700 1000 1400 2000 3000 5000 10000 



•; RATHER THAN CREATING A FILTER 8Y MANUALLY POSITIONING POLES AND ZEROES, 

* 

•J LET'S USE A PREDEFINED MACRO. 
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• INC 
*DEF 

* ; 

* : 

* ; 



LUDE iFliCHEB.H 

MAC CHEB ;*** 

A CHEBYSHEV 

CALLING SEQUEHC 
WHERE ORDER is 
Fco is th 
LABEL is 
R.F. is t 

EXAMPLE 



AC ; DESI 

************ 

FILTER GENE 

E :CHEB ORD 
the order of 
• cutoff frt 
the star ti ng 
he desired < 

iCHEB 6.50 

this V i I 

6, cutof 
dB, prod 



RED MACRO IS DEFINED IH THIS FILE 
***************************************** 

RATOR FOR SPAC20 ** 



ER, Fco, LABEL, R.F. 

the filter 
quency in Hz 

point for pole numbering 
or allowable) ripple factor in 



dB 



** 
** 
** 
** 
** 



0,23,0.12 

I generate a CHEBVSHEV filter of order ** 

f=500.and a peak-to-peak ripple of 0.12 *♦ 

ucing 3 conplex poles labeled 23,24,25 ** 



* DEF 

* DEF 
*DEF 

* IF 
* 

* END 

* REM 

* DEF 

* DEF 

* DEF 

* DEF 

* REP 



. ?CHEBYRIP=10**< ABS<*3>/10>-1 

?SINHP=1 
. ?C0SHP*1 

7CHEBYRIP <> 
iTENCHB ?SIN 



THEN 
HP, . 7C0SHP, . ?CHEBYRIP,XO 



?CHEB 
I HE . ? 
IHE .? 
I HE ? 
IHE .? 
EAT 
?BUTIH 
?BUTAH 

IF .? 

EHD 
>EF POL 



YRIP 

BUTSTAR 

BUTDELT 

BUTIHDE 

BUTAHGL 

DEX = . 
GLE=.?B 
BUTAHGL 
?BUTAHG 



* DEF P0L< .?BUTI 
** -SSI* . ? 

* * 

* WHILE . ?BUTIND 

* EHD 

* REM 

* REM 

* REM 

* REM 

* REM 

* REM 
*PZ 

* EN 



T ■ < HPI 
A = < PI/fcO 
X = 
E-0 

?BUTIHDEX + 
UTSTART - .? 
E < ?BUTDEL 
LE = 

HDEX+*2-l>= 
SIHHP*C0S< .? 
*1*.?C0SHP*S 
EX + 1 <= < 



+ ( HPI/XO > 
> 



1 

BUTINDEX*. ?BUTDELTA 

TA/4 THEN 



BUTANGLE), 

INC .?BUTANGLE) 

XQ + 1 > / 2 



?BUTINDEX 

7BUTDELTA 

78UTSTART 

7BUTAH6LE 

7SIHHP 

7C0SHP 



',* BEGIN THE 


** 


;* CHEBYSHEV 


** 


;* BY SETTING 


** 


;♦ DEFAULT VALUES, 


** 


;** OR USE THE 


** 


;♦♦ SUB-MACRO 


** 


;♦♦ TO GEHERATE 


** 


;♦♦ THE VARIABLES. 


** 


{♦♦ 


** 


;* A MODIFIED 


** 


;* BUTTERUORTH 


** 


;* MODULE IS 


** 


;* IHCORPORATED 


** 


,* TO GENERATE 


** 


;* THE APPROPRIATE 


** 


;* PATTERN OF 


** 


;* POLES FOR THE 


** 


;* FILTER. (the fcs 


** 


,' * allow greater 


** 


; * readab i I I ty of 


** 


;♦ the fornula . > 


** 


;♦♦ REMOVE THE 


** 


;♦♦ VARIABLES 


** 


;** INTRODUCED 


** 


;** IN THIS MACRO, 


** 


J** TO SAVE SPACE. 


** 


;*♦ 


** 



*s TE 
• DEF M 
.*; CA 
. * ; 
.♦DEF 

♦ DEF 
.♦DEF 

. *'<0«< 
.*%1«< 

♦ REM 

♦ REM 



NCHB GET 

AC TEHCHB 

LLIHG SEQUEHC 
iTENCHB S 

. ?IHVSXTEMP*( 
?INVSXTEHPP= 
?INVSXTEMPH* 

.?IHVSXTEMPP 

.?IHVSXTEMPP 
7IHVSXTEMP 
7INVSXTEHPP 



;******* EHD OF CHEBYSHEV MACRO **••*♦♦* 
VARIABLES FOR CHEBYSHEV FILTER § ttMttMttffttfft itttl 



INHP,COSHP,E 
1XSQR<%2 >> + < 
.7INVSXTEHP 
.7INVSXTENP 
- 7INVSXTEH 
♦ . 7INVSXTEH 





ft THIS IS THE 


• tt 


♦ *2,N 


tt SUB-MACRO. 


itt 


SQR<< 1/!C2>*1>> 






**< 1/3:3) 




;flt 


**< -l/*3 > 






PH>/2 




;Mt 


PH>/2 




;#tt 
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ALL THE ABOVE MACRO DEFINITION CAME FROM THE INCLUDED FILE : F 1 : CHEB . MAC . 



•REMOVE ?Z i DELETES ALL OLD POLES AND ZEROES 

1 P0LES/2ER0ES REMOVED 

* 

*; HOW INVOKE MACRO CHEB TO BUILD A CHEBYSHEV LOW PASS FILTER. 

*;CH£B 7,1000,0,2 ; 7TH ORDER, 1000 H2 CUTOFF, 1ST LABEL 0, 2 DB RIPPLE 
A CHEBYSHEV FILTER GENERATOR FOR SPAC20 ** 



LLING SEQUENCE iCHEB ORDER, Fco, LABEL, R.F. 

ERE ORDER is the order of the filter 
Fco is the cutoff frequency i r» Hz 
LABEL is the starting point for pole numbering 
R.F. is the desired < or allowable) ripple factor 



in dB 



** 
** 
** 
** 
** 



EXAMPLE iCHEB 6,500,23,0.12 

this will generate a CHEBYSHEV filter of order ** 
6, cutoff =500 , and a peak-to-peak ripple of 0.12 *♦ 
dB, producing 3 conplex poles labeled 23,24,25 ** 



♦ DEF . •>CHEBYRIP»10**< ABSC2 >/10 >-l 
*DEF ?SINHP=1 

*0£F .?C0SHP=1 

* IF ?CHEBYRIP <> THEN 

* ;TEMCHB ?SINHP , . ?C0SHP, . ?CHEBYR IP , 7 

' CALLING SEQUENCE 
*; :TEMCHB S I MHP, COSHP , E**2 , N 



* BEGIN THE ** 

;* CHEBYSHEV ** 

;* BY SETTING ** 
J* DEFAULT VALUES, ** 

;** OR USE THE ** 

•* THIS IS THE ##« 

»• SUB-MACRO. ##• 



*DE 
*DE 
*OE 



*RE 
*RE 
*RE 
*EM 
EN 
♦ SEN 
OEF 
i£F 
£'£F 
DEF 
REP 



F . ?INVSXTEMP=< 1/SQRC . ?CHEBYRI P > )+< S6R< C 1 / . ?C HEBYR I P > + l ) > 

F . ?INVSXTEMPP=. ?INVSXTEMP **<l/7> ittt 

F . ?INVSXTENPN= . ?INVSXTEHP **<-l/7) 

SINHP=< . 7INVSXTEMPP - . ?I N VSXTEMPN U2 

COSHP=< ?INVSXTEMPP + . ? I NVSXTEMPN >/2 

M ?INVSXTENP J#*# 

M 7INVSXTENPP 

M 7INVSXTEMPN i ## END OF TEMCHB t«l 



Iff 



D 

. ?C 
I ME 
I HE 
INE 
I HE 
EAT 
. ?B 
?B 
I 






. * £N 

* REM 

* ft£M 

* REM 

* REM 

* REM 

* REM 
*fZ 
*£M 

POLE 
POLE 1 
POLE 2 
POLE 3 



HEBYR IP 

?BUTSTART = ( HP I > + < HP1/7 > 
. 7BUT0ELTA = < PI/7 ) 

?BUTINDEX = 
. ?BUTANGLE=0 

UTINDEX = ?BUTINDEX + i 

UTANGLE" ?BUTSTART - . ?BUTI NDEX* . ?BUTDEL TA 

F .?BUTANGLE < :?BUTDELTA/4 THEN 

. ?BUTANGLE=G 
END 
DEF P0L< .?BUTINDEX+0-l>= 8= 

-1000*. ?SINHP*C0S< ?BUTANGLE >, I 

1000*. ?COSHP*SIN( ?BUTANGLE> 
LE ?BUTIND£X + 1 <= < 7 + 1 > V 2 

>BUTINDEX 

►BUTDELTA 

>BUTSTART 

>6UTANGLE 

>SINHP 

>C0SHP 



UHI 
D 



; ** 
; ** 
** T 
** 

;* A 
j* B 
;* M 

; * 

; ••» 

i * 
; * 
; * 
;* F 



;* t 



SUB-MACRO 
TO GENERATE 
HE VARIABLES 



** 

* * 

* * 

** 

** 
** 
** 



MODIFIED 
UTTERWORTH 
ODULE IS 
INCORPORATED 
TO GENERATE 
THE APPROPRIATE ** 
PATTERN OF ** 

POLES FOR THE ** 
ILTER . < the fcs ** 
; * al 1 ow greater ** 
i * readability of ** 
he formula.) ** 



;■»» REMOVE THE ** 

;** VARIABLES ** 

;** INTRODUCED ** 

;** IN THIS MACRO, ** 

;** TO SAVE SPACE. ** 

; ** ** 



;,*,»*** END OF CHEBYSHEV MACRO ******** 
-3 4 .5 66 349, 9 8 6. 620 48, CONTINUOUS 
-96.852775,791 . 20825, CONTINUOUS 
-139. 95634 4,4 39.08 737, CONTINUOUS 
-155 33 9813,0 .0 000 00 00, CONTINUOUS i REAL 



*; ONE REAL POLE AND THREE COMPLEX POLE PAIRS WERE CREATED. 

* 

*YSC = -5,1 ; SELECT A NEW VERTICAL SCALE FOR GAIN 
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*GR G ; GRAPH GAIN (MANY KEYWORDS HAVE ONE OR TUO LETTER ABBREVIATIONS) 

GAIN ! A . . . A A ... ,v ... A .... A .... A . ...*....* A A ! 

1 
71 
43 

14 

-0 14 - 

-0 43 

-0 71 

-I 00 

-12? 

-15? 

-1 86 '--...- 

-2 14 

-2 43 

-2 71 

-3 00 

-3 29 

-3 5? 

-3 86 

-4 14 

-4 4 3 

-4 ?1 

-5 00 ********************************** 

P*B I H2 1 A A A A A A A A A A A | 

100 150 200 300 400 500 700 1000 1400 2000 3000 5000 10000 

*} ASTERISKS (ABOVE 1000 HZ HERE> INDICATE VERTICAL SATURATION. 

*; LET'S ZOOM IN ON THE REGION NEAR 1000 HZ. 

* 

*FSCALE = 400, 500,600; 700, 800,900, 1000, 1100 i NEW FREQUENCY RANGE 

*GR G ; GRAPH GAIN 

q (f ; h i ! ... A .....!... A ! ... A ....!... A ! . . . A ! .... A .... ! 

1 00 
0. 71 
43 

14 . .--. 

-014''- - 

-0 43 ' . ' ' . ' . 

-0 ?! 
-1 00 

-129 - . ' . - 

-15? '-. .- - 

-1 86 '-....-' 

-214' 
-2 43 
-2 ?! 
-3.00 
-3 29 
-3 5? 
-3 86 
-4 14 
-4 43 
-4 ?1 
-5 00 ********* 

OB I HZ ! ! . . . A ! . . . A ! ... A ....!... A ! . . . A ! .... A .... ! 

400 500 540 600 640 700 740 800 840 900 940 1000 1050 1100 



*> WELL, LET'S NOW HOVE INTO THE WORLD OF SAMPLED FILTERS. 

* 

♦MOVE POLES TO TS J CONVERT FILTER TO SAMPLED VIA MATCHED-Z TRANSFORM 

ERR 73:SA«PLE RATE UNDEFINED 

* 

*J SAMPLE RATE MUST BE SPECIFIED FIRST. 

* 

*TS =» 1/13020 ; REASONABLE RATE FOR FULL 192 INSTRUCTION 2920 PROGRAM 

TS = 7.6805004/10**5 
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♦HOVE POLES TO TS i TRY AGAIN 

4 POLES/ZEROES MOVED 

* 

*P2 ; LET'S SEE WHAT WE HAVE 

POLE = -34. 566349.986. 62048, TS 

POLE 1 = -96. 832775, 791. 20825, TS 

POLE 2 = -139.956344.439.08737, TS 

POLE 3 = -155. 339813,0. 00000000, TS; REAL 

* 

; THIS INTRODUCES COMPENSATION FOR SAMPLE AND HOLD DISTORTION 

GRAPH GAIH OF SAMPLED VERSION OF FILTER OVER ORIGINAL VERSION 



+ ' . 

*- . 

+ - . . ' • 

+- . -+ + 

♦+-. . . . - ' + 

•f + ' ' ' ++ + 



♦HOLD ON 


* 




♦ OSR G 


GAi 


IN 


1 


00 





■? i 





43 





14 


-0 


14 


-0 


43 


-0 


?1 


-1 


00 


-1 


29 


-1 


5? 


-1 


8 b 


-i 


: - 


_ 2 


43 


-2 


71 


-3 


00 


-3 


29 


-3 


57 


-3 


86 


-4 


14 


-4 


43 


-4 


71 


-5 


00 



CB I HZ • ! . . . A ! . . . A ! ... A ....!... A ! . . . * !....*....! 

400 500 540 600 640 700 740 800 840 900 940 1000 1050 1100 

*; OBSERVE THAT THE SAMPLED FILTER CLOSELY RECREATES THE CONTINUOUS FILTER. 

* 

*; IF WE HAD CONVERTED TO SAMPLED USING BILINEAR TRANSFORM INSTEAD OF 

♦ ; MATCHED-Z, THE GAIN CURVES WOULD HATCH EVEN MORE CLOSELY. 

*; HOW THAT WE'RE SATISFIED WITH THIS FILTER, LET'S GENERATE 2920 CODE FOR IT. 

♦ PUT : Fl s BEFORE. TMP PZ .* SAVE THE CURRENT POLES IN A DISK FILE BACKUP 
♦ 

♦CODE POLE INST<11 ; WILLING TO DEDICATE 10 INSTRUCTIONS TO POLE 

Bl-1 7481516 B2=-0. 96718828 

INST=4 
POLE = 0.00000000, 3255. 0000, TS 

BEST YET 
POLE = -718.16894, 1627. 50000, TS 

BEST YET 

INST=5 
POLE - 0.00000000, 1497. 64807, TS 

BEST YET 
POLE = -32. 894828, 3255. 0000, TS 
POLE ' -32. 894828, 3255. 0000, TS 
POLE * -785. 03710, 1558. 37561, TS 

INST=6 
POLE = 0.00000000, 1047. 20678, TS 

BEST YET 
POLE = 0.00000000, 1497. 64807, TS 
POLE * 0.00000000, 1047. 20678, TS 
POLE » 231. 19877, 960. 76947, TS 
POLE = -298.06701, 1084. 99975, TS 
POLE = -34. 920330, 3255. 0000, TS 
POLE = -34. 985778, 3255. 0000, TS 
POLE » -820.16253, 1520. 12536, TS 
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INST-? 
POLE = 0.00000000,978.23999, TS 

BEST YET 
POLE * 00000000, 1047. 20678, TS 
POLE > 00000000,1051. 37915, TS 
POLE ' -32. 894828, 985. 61517, TS 
BEST YET 

-32.894828, 985.61517, TS 
-298.06701, 1084.99975, TS 
-32. 894828, 985. 61517, TS 
204. 96688, 906. 54 724, TS 
■276. 7034 3, 1121. 26489, TS 
-3 4.47 998 0,325 5.0000, TS 
34. 462657, 3255. 0000, TS 
-820.16253, 1520. 12536, TS 



. 00000000, 987 .10296, TS 
. 00000000, 1051 .37915, TS 
0.00000000, 1051. 18432, TS 
-32. 894828, 986. 73706, TS 

-32. 894828, 986. 73706, TS 
-32. 894828, 985. 6 151 7, TS 
-32. 894828, 990. 09570, TS 
-34.920330,981 .6 7358, TS 
-34.985778,981 .54 577, TS 
-276.70343, 1 121 . 26489, TS 
19 1.59779, 877. 43200, TS 
-34 . 549556, 3255 . 0000, TS 
-34. 593387, 3255. 0000, TS 



. 00000000, 986. 53126, TS 
0.00000000,1051. 18432, TS 
0.00000000, 1051. 18432, TS 
-32. 894828, 990. 09570, TS 
-32. 894828, 989 . 88684, TS 
-34. 920330, 986.1 7498, TS 

-34.985778,986.04 791, TS 
-34.985778,986.04 791, TS 
-34. 479980, 982. 53204, TS 
-34. 462657, 982. 56579, TS 
-34.549934,3253.0000, TS 



0.00000000, 1051. 18432- TS 
. 00000000, 1051 . 208 74, TS 
■32. 894828, 989. 88684, TS 
■32. 894828, 989. 88684, TS 
-34. 920330, 986. 7365 1,TS 

■34. 985778, 986. 60949, TS 

-34.985778,986.04 791, TS 

•34. 985778, 985. 83789, TS 

■34.479980,987.02893, TS 

-34. 462657, 987. 06262, TS 

-34. 724 136, 986. 55566. TS 

BEST YET 

POLE * -34. 549556, 982. 39642, TS 

POLE = -34. 593387, 982. 31103, TS 

POLE = -34. 550563, 3255. 0000, TS 

IHST-10 
POLE =» -34. 724136, 986. 55566, TS 
BEST 
PERROR * 0.157787329, 0.064819335 
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J NOTE: HAKE SURE SIGNAL IS <0. 57206704 
LDA 0UT2.P0, OUT1_PO,ROO 

OUT2_PO*1.00000000*OUT1_PO 
LDA 0UTl_P0,OUTO-PO,R0O 

; 0UT1_P0=1 00000000*OUTO_PO 
SUB OUTO-PO,OUT1_PO,R02 

.: 0UT0_P0=1 00000000*OUTO-P0-0 . 25000000*0UT 1..P0 
SUB OUTO-PO, OUTl.PO.RO? 

:■ OUT 0_ POM .000 00000*0 UT0_P 0-0 . 25 1953 1 2* OUT i_P0 
ADO OUTO-PO. OUT1_PO,ROO 

OUTO_PO=1.00000000*OUTO.PO+0. 748046 87* OUT 1.P0 
ADD QUT0_P0,0UT2_P0,R05 

; 0UT0_P0»=1 . 000 00 00*0 U TO _P 0+0 . 7 480 46 8 7* OUT l_PO + . 03 1 25 000 0* 0UT2-P0 
ADD OUTO-PO, 0UT2_P0,R09 

. OUTO_PO«1.00000000*OUTO_PO+0 .7 4804687* OUT l.PO+O . 03 32031 2 5*0UT2_P0 
SUB OUTO-PO, 0UT2_P0,R12 

i OUTO-PO- 1 . 00000 00Q*0U TO _P 0+0 7 4804687* OUT 1-PO+O . 032958984*0UT2_P0 
SUB OUTO-PO, OUT2_P0,R0O 

; OUTO-PO* 1 . 00000 000*0U TO _P 0+0 . 7 48046 8 7* OUT l.PO-0. 96 704 101 *0UT2.P0 
ADD OUTO-PO, INO_PO,R00 

; OUTO-PO* 1 . 00000000 *0UT0_P 0+0 7480468 7* OUT l-PO-0 . 96 704 10 1 *OUT 2 -P0+ 1 . 000 000 00* I NO-PO 
* 
*) THE DISPLAY SHOWS EVERY ATTEMPT TO GENERATE CODE FOR POLE 0, GIVING IN 

*; EACH CASE THE POLE POSITION CORRESPONDING TO THE CODE. THE MESSAGES 

*J "BEST YET" AND "BEST" INDICATE THE PROGRESS OF THE CODING ATTEMPTS. 

* 

*i SINCE UE DID NOT SPECIFY AN ERROR CONSTRAINT IN THE CODE COMMAND, 

*; DISTANCE IN THE S-PLANE FROM THE ORIGINAL POLE WAS MINIMIZED. 

* 

*J POLE IS NOW MOVED TO THE POSITION CORRESPONDING TO THE BEST CODE. 

*; THE CODING ALGORITHM SELECTED REQUIRES THAT THE OUTPUT SIGNAL NOT 

*; EXCEED 0.572 IN ORDER TO PREVENT INTERMEDIATE CALCULATIONS FROM 

*; OVERFLOWING. 

*PUT sFliCODE.SRC '; 7TH ORDER CHEBYSHEV , CODE ; SAVE CODE IN NEW FILE 

* 

*; INSERT IN GROWING CODE FILE CODE TO PASS SIGNAL FROM FIRST STAGE TO SECOND. 

♦APPEND SFliCODE.SRC 'IN0-P1 EQU OUTO-PO' i INPUT TO SECOND IS OUTPUT FROM FIRST 

* 

*CODE POLE 1 INST<11 ; CODE POLE 1 NEXT IN 10 INSTRUCTIONS OR FEWER 

Bl-1. 7712245 B2--0 . 91 07576 1 

INSTM 
POLE 1 * 00000000.3255.0000, TS 

BEST YET 
POLE 1 » -718.16894, 1627.30000, TS 

BEST YET 

INST=5 
POLE 1 ■ -66.868217,3255.0000, TS 
POLE 1 * -66. 868217,3255.0000, TS 
POLE 1 = -1016.23577, 1275. 39575, TS 
8EST YET 

IHST-6 
POLE 1 = 0.00000000, 736. 50292, TS 

BEST YET 
POLE 1 = .00000000, 1047.20678, TS 
POLE 1 * 0. 00000000, 1047.20678, TS 
POLE 1 * 122. 034751, 704. 20874, TS 
POLE 1 = 122.034751,704.20874, TS 
POLE 1 = -99. 763069, 3255. 0000, TS 
POLE 1 - -101 .993606, 3255. 0000, TS 
POLE 1 = -1013.54125, 1279. 19873, TS 
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INST-10 

POLE 1 » .00000000, 1000. 82678, TS 

POLE i * .00000000, 1000.81738, TS 

POLE 1 * -66.868217,791 .33288, TS 

POLE 1 * -66.868217,791 .33288, TS 

POLE 1 = -66.868217,862 .28106, TS 

POLE 1 = -99.763069,788 .89288, TS 

BEST YET 

POLE 1 = -101 .993606,791 .89245, TS 

POLE 1 » -101 .993606, 774.43041 , TS 

POLE 1 = -101 .993606, 778. 24249, TS 

POLE 1 = -97^53,7277,805 .69842, TS 

POLS 1 = -97.537277,305.69342; TS 

POLE 1 = -102. 551963, 793. 35278, TS 

POLE 1 » -97. 537277,794 .43249, TS 

BEST YET 

POLE 1 * -96. 838409,850.94934, TS 

POLE 1 ■ -96.981559,850.62072, TS 

POLE 1 » -118. 310440, 799. 93048, TS 

POLE 1 - -118 .310440, 799. 93048, TS 

POLE 1 » -96. 837249,3255.0000, TS 

INST»10 
POLE 1 * -97.537277,794 .43249, TS 
BEST 
PERROR * 0.68450166, -3.2242431 

,' NOTE: HAKE SURE SIGNAL IS <0. 56512143 
LDft 0UT2_P1,0UT1_P1 ,R00 

; QUT2_P1»1 00000000*OUT1_P1 
LDA OUT1_P1,OUTO_P1 ,R00 

; OUT1_P1*1.00000000*OUTO_P1 
ADD 0UT0.P1,0UT1_P1,R02 

; 0UT0_P1=1 . 00 00 00*0 UT0_P 1+0 .2500000 D*0UT1_P1 
ADD 0UT0-P1 ,OUTO_P1 ,R06 

; 0UT0_P1*1 01562500*0UT0_P1+0.25390625*0UT1_P1 
ADD 0UT0-P1 ,0UT1_P1 ,R01 

; 0UT0_P1=1.01562500*0UT0_P1+0.7 53906 25*0UT1_P1 
ADD 0UT0-P1 ,0UT2_P1 ,R04 

; 0UT0_P1=1 015625Q0*0UTO_P 1+0 .753906 25* OUT l_ PI +0 06 2500000* 0UT2.P1 
ADD 0UT0-P1,0UT2_P1 ,R05 

i OUT 0_P1=1.01562500*OUTO_P 1+0. 7 539 06 25*0UT 1_P1 +0. 09 3 75 00 0*0UT2_P1 
SUB 0UT0.P1 ,0UT2.P1 ,R08 

; 0UT0_P1=1 01562500*0UT0_Pl+0.75390625*0UTl_Pl+0. 08984 3750*0UT2_P1 
SUB 0UT0-P1 ,0UT2_P1,R00 

; OUTO_P1=1 . 01562 5OO*0U TO _P 1+0 . 753906 25*0UT 1_P1 -0. 910 15625*0UT2_P1 
ADD 0UT0-P1 , IN0_P1,R00 

J 0UT0_P1=1 . 015 62 5 00*0UT0_P 1+0 ?5390625*0UT 1_P1 -0 . 910 15 625*0UT2 -P 1 + 1 .00000000* I NO- PI 
* 

♦ APPEND :F1':C0DE.SRC CODE i SAVE CODE AT END OF GROWING FILE 

* 

♦APPEND :Fl:CODE.SRC 'IN0.P2 EQU 0UT0.P1' ; INPUT TO THIRD IS OUTPUT FROM SECOND 

* 

*CODE P 2 INST<11 ; CODE POLE 2 NEXT 

Bl=l 8275704 B2 = -0 . 87364599 

INST=4 
POLE 2 = .00000000,3255.0000, TS 
BEST YET 

INST=5 
POLE 2 = -138 .351623, 3255.0000, TS 

BEST YET 
POLE 2 = -138 .351623,3255.0000, TS 
POLE 2 = -1314.30297,704.20874, TS 

BEST YET 

INST =6 

POLE 2 = . 00000000, 366 .79486, TS 

BEST YET 

POLE 2 = .00000000,736 .50292, TS 

POLE 2 = .00000000,736 .50292, TS 

POLE 2 = 31 .882545,362.57061 ,TS 

POLE 2 = 31 .882545,362.57061 , TS 

POLE 2 = -140 .377334, 3255. 0000, TS 

POLE 2 = -139 .508758,3255 .0000, TS 

POLE 2= -1285. 91467, 780. 04730, TS 



1-15 



Introduction SPAC20 Compiler 



INST-10 
POLE 2 = 0. 00000000, 866. 7 1618, TS 
POLE 2 =■= 0.00000000, 866. 76428, TS 
POLE 2 = -138 .351623, 438. 47937. TS 
POLE 2 = -138. 351623, 438. 47937, TS 
POLE 2 = -138 .351623,446. 13854, TS 
POLE 2 = -140.377334,434. 17916, TS 
POLE 2 = -139. 508758, 438. 24417, TS 
POLE 2 = -139.508758, 438. 24417, TS 
POLE 2 = - 139. 508758, 44 1.1 3485, TS 
POLE 2 - -140.015365,512.25738, TS 
POLE 2 = -140. 087631, 511. 97113, TS 
POLE 2 = -156. 432159, 442. 24893, TS 
POLE 2 = -139. 363952, 438. 91845, TS 

8EST YET 
POLE 2 = -89 232948,427.92999, TS 
POLE 2 = -89. 232948, 427. 92999, TS 
POLE 2 = 39. 337009, 402. 49118, TS 
POLE 2 = 39. 337009, 402. 49118, TS 

INST=>10 
POLE 2 = -139. 363952.438. 91845, TS 
BEST 
PERROR = -0.59239199, 0.16891479 

,' MOTE: HAKE SURE SIGNAL IS <0. 54700859 
LDA 0UT2_P2,00T1_P2,R00 

: 0UT2_P2=1.00000000*QUT1_P2 
LDA 0UT1_P2,00T0_P2,R00 

; GUT1_P2=1.00QOOOOO*OUTO_P2 
ADD 0UT0_P2,0UTl_P2.R0i 

: 0UTO_P2*l 00000000*OUTO_P2+0.50000000*OUT1_P2 
ADD OUTO_P2,OUT1-P2,R03 

■ 0UT0_P2*1 00Q00000*0UT0_P2+0 62500000*0UT1_P2 
ADD 0UT0_P2,0UT0_P2,R03 

: 0UT0_P2=1. 12500000*OUTO_P2+0.70312500*OUT1_P2 
ADO 00T0_P2,0UT2_P2,R03 

,' 0UT0_P2=1. 12500000*OUTO_P2+0.7 0312500*OUT1_P2 + 0. 1 25000000*00 T2_P2 
ADD 0UT0_P2,0UT2_P2,R10 

; 0UTO_P2*l . 12500000*OUTO_P2+0 . 70312500*0UT 1.P2+0. 125976562*0UT2_P2 
SUB 0UT0_P2,00T2_P2,R13 

; 0UT0_P2=1 . 12500000*0UT0_P2+0 . 70312500*OUT 1.P2+0 . 125854492*0UT2_P2 
SOB 0UT0_P2,00T2_P2.R00 

; 0UT0_P2«1. 12500000*0UT0_P2+0. 7031 2500*OUT1_P2-0. 874 14550*0UT2_P2 
ADO 0UT0-P2. IH0_P2,R00 

J QUT0_P2*1 . 12500OOO*0UT0_P2+0.7031250O*OUTl.P2-0.8741455O*0UT2_P2*l .00000000* IN0.P2 
* 
♦APPEND :Fl: CODE. SRC CODE J SAVE CODE 

♦APPEND sFliCODE.SRC ' IN0-P3 EQU OUT0-P2' ; INPUT TO FOURTH IS OUTPUT FROM THIRD 

♦ 

♦CODE P 3 INST<11 ; CODE POLE 3 LAST 

81*0.92777714 B2*0 OOOOOOOO 

IHST=2 
POLE 3 * 0.00000000,0. 00000000, TS; REAL 
BEST YET 

INST«3 
POLE 3 = 0.00000000,0. 00000000, TS; REAL 
POLE 3 = 0.00000000,0. 00000000, TS; REAL 
POLE 3 = -133. 736541,0. 00000000, TS; REAL 
BEST YET 

IHSTM 
POLE 3 = -133. 736541,0. 00000000, TS; REAL 
POLE 3 = -133. 736541,0. 00000000, TS; REAL 
POLE 3 = -151 .077224, 0.00000000, TS; REAL 
BEST YET 

INST=5 
POLE 3 = -151 .077224, 0.00000000, TS; REAL 
POLE 3 - -151 .077224, 0.00000000, TS; REAL 
POLE 3 = -155. 401062,0. 00000000, TS; REAL 
BEST YET 

INST*6 
POLE 3 = -155. 435150,0. 00000000, TS; REAL 
POLE 3 = -155. 401062, . OOOOOOOO, TS; REAL 
POLE 3 = -155. 356887,0. OOOOOOOO, TS; REAL 
BEST YET 
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1 N 5 T = 7 
POLE 3 = -153. 435130,0. 00000000, TS; REAL 
POLE 3 = -155. 356887,0. 00000000, TSJ REAL 
POLE 3 » -155. 344894,0. 00000000, TS; REAL 

BEST YET 

INST=8 
POLE 3 = -155. 435130,0. 00000000, TS; REAL 
POLE 3 = -155 .344894, 0.00000000, TS; REAL 
POLE 3 = -155. 337036,0. 00000000, TS; REAL 
BEST YET 

INST*9 
POLE 3 = -155. 435150,0. 00000000, TS; REAL 
POLE 3 = -155. 337036.0. 00000000, TSJ REAL 
POLE 3 « -155. 340621,0. 00000000, TS; REAL 
BEST YET 

INSTMO 

POLE 3 = -155. 435150,0. 00000000, TS; REAL 

POLE 3 * -155. 340621,0. 00000000, TS,' REAL 

POLE 3 = -155. 340621,0. 00000000, TS; REAL 

INST=9 
POLE 3 = -155. 340621, . OOOOOOOO, TS; REAL 
BEST 
PERROR - 8.0871562/10**4, 0.00000000 

LDA 0UT1_P3,0UTQ_P3,R00 

: OUT1_P3=1.00000000*OUTO_P3 
SUB 0UT0-P3,0UT1-P3,R07 

; 0UT0_P3*1 . 00000000*OUTO_P3-0 0078125000*OUT1_P3 
SUB 0UT0_P3,0UT0-P3,R04 

; OUTO_P3»0.93750000*OUTO_P3-0. 0073242 187*0UT1_P3 
SUB 0UT0_P3,0UT1-P3,R07 

: 0UTO_P3»O.93750000*0UTO_P3-0.015136718 7*0UTl_P3 
ABO 00T0_P3,0UT0_P3,R09 

; OUTO_P3«Q.93933105*OUTO_P3-0.0151662826*OUT1_P3 
ADD 0UT0_P3,0UT1_P3,R11 

: 0UT0_P3*0. 93933 105*OUTO_P 3-0. 01 4678001 4*0UT1_P3 
ADD 0UT0_P3,0UT0_P3,R08 

; 0UT0_P3=0. 94300029*0UT0_P3-0 . 1 4?353378*0UT 1-P3 
SUB 0UT0_P3,0UT1.P3,R11 

; OUTO_P3-0.94300029*OUTO_P 3-0. 01 52236 190*0UT1_P3 
ADD QUT0-P3, IN0_P3,RQ0 

; OUTO_P3=0.94300029*OUTO_P3-0. 01 52236 190*0UT1_P3+ 1.00000000* I N0_P3 
* 

♦APPEND :F1:C0DE.SRC CODE 1 SAVE CODE 

* 

*; NOW ALL OUR POLES ARE CODED. 
* 

*; LET'S SEE WHAT THE GAIN RESPONSE LOOKS LIKE FOR OUR FILTER AS CODED. 
* 

*; RECALL THAT THE LAST ITEM GRAPHED HAS THE GAIN FOR THE SAMPLED UHCODED FILTER. 
* 
*OGR G ; GRAPH GAIN AS CODED OVER ORIGINAL SAMPLED GAIN 

GAIN ! !... A !...*• ! . . . A . . ..!... A • . . . * !....*....! 

1 00 

71 

43 + -. ++ 

14 . --' '- . . ' ' . ' 

-014 '. +- - .♦ 

-0 43 -. +' ' ♦ 

-0 ?! - + 

-1 00 '-+ ♦ . ♦- 

-12? '.+ .- +'-.-' 

- i 5? '-.+ ++.- +++ 

-1 86 ' ' 

-2 14 
-2 43 
-2 71 
-3 00 
-3 29 
-3 57 
-3 86 
-4 14 
-4 43 
-4 71 
-5 00 ' ******** 

DB I H2 ! ! . . . A ! . . . * !...*.... I ... * ! . . . * !....*....! 

400 500 540 600 640 700 740 800 840 900 940 1000 1050 1100 
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*; CLOSE ENOUGH FOR OUR PURPOSES. 

*; UE MUST NOW SELECT APPROPRIATE SCALING FACTORS FOR OUR GENERATED CODE. 

♦PUT :F1 : AFTER .TUP P2 J SAVE IN A FILE THE CURRENT POLE POSITIONS 

* 

♦REMOVE POLES 1 THRU 3 ; LEAVE ONLY FIRST POLE 

3 POLES/ZEROES REMOVED 

♦ 

♦HOLD OFF ; SAMPLE AND HOLD COMPENSATION NOT HEEDED DURING SCALING 

♦ 

♦YSCALE = AUTO i SO UE CAN FREELY GRAPH ABSOLUTE GAINS 

♦ 

♦ GR AGAIN l GRAPH THE ABSOLUTE < MULT ILP ICAT I VE > GAI N FOR POLE 

A G ft I M ! ! . . . A ! . . . A ! ... A ....!... A ! . . . * ! .... A .... ! 

65 9 

63 

6 1 

5? 2 

54 4 ' 

51 5 

48 6 

45 .7 

42 9 

40.0 

37 1 

34 2 ' ' . 

314 - 

28.5 

25 6 - 

22 7 

19.9 

17 

14 1 .--' 

112 ...-'' 

8 4 ' ' ' 

5 5 . >>.,..,, 

AMP I HZ ! ! . . . A !.. . A .....!.. , A ....!... A ! . . . A ! ... . A .... ! 

400 500 540 600 640 700 740 800 840 900 940 1000 1050 1100 
♦ 
♦ 
* 

*; THE MAXIMUM AGAIN IS A GOOD GUIDLINE FOR THE NECESSARY SCALING. 
♦ 
*i UE MUST ALSO TAKE INTO ACCOUNT THE CODE BUFFER COMMENTS WHICH 

*; INSTRUCTED US TO LIMIT SIGNALS TO PREVENT INTERMEDIATE 

♦ 

*; CALCULATIONS OVERFLOU. 

*; TO BE VERY SAFE- WE SHOULD ACTUALLY MAKE SURE THE SIGNAL COMING 

* 

*; OUT OF EACH STAGE IS LESS THAN ONE FOURTH. 

* 

♦EVALUATE MAGAIN i THE MAXIMUM AGAIN CAN ALSO BE ACCESSED THIS WAY 

6. 586i554*10^1 

♦ 

♦ EVALUATE LOG< MAGAI N >^JLOG( 2 > ; I.E. LOG BASE 2 OF MAXIMUM AGAIN 
6 .0413646^10^0 

♦ 

♦; THIS SIGNAL MUST BE SCALED BY AT LEAST THIS MUCH BEFORE ENTERING FIRST POLE. 

* 

♦; THIS SCALING MUST BE EDITED INTO THE CODE FILE LATER BY HAND, 

♦ 

♦ J BUT WE'LL APPEND NOTES TO THE CODE FILE NOW TO REMIND US. 
♦ 

♦APPEND tFl:CODE.SRC '; SCALE INPUT TO POLE WITH RIGHT 8 SHIFT' ; MAKE NOTE 
♦ 

♦ REK POLES ; REMOVE POLES 
1 POLES/ZEROES REMOVED 

♦ 

♦INCLUDE sFl iAFTER. TMP ; GET OUR FILTER AS CODED BACK AGAIN 

♦DEFINE POLE = -34 . 724 136, 986 . 55566 , TS 

♦DEFINE POLE 1 = -97 . 537277 , 794 . 43249 , TS 

♦DEFINE POLE 2 = -1 39 . 363952> 438 . 9 1845, TS 

♦DEFINE POLE 3 = -1 55 . 34062 1 , . 00000000 , TS I REAL 
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•REM P 2 THRU 3 ; MUST LOOK AT FIRST TWO STAGES NEXT 

2 POLES/ZEROES REMOVED 

* 

•EVALUATE LOG< HAGAI N )/LOG< 2 > ; SCALING FACTOR NEEDED BEFORE SECOND STAGE 

9 . 6666240*10**0 

* 

*; UE HAVE ALREADY SCALED BY 2**8 SO ANOTHER 2**4 WILL SUFFICE. 

♦ APPEND t Fl iCODE.SRC '; SCALE INPUT TO POLE 1 WITH RIGHT 4 SHIFT' ; HAKE NOTE 

* 

*REt1 P ; REMOVE POLES 

2 P0LES/2ER0ES REMOVED 
* 

♦ INCLUDE sFl .AFTER. TMP J GET OUR FILTER AS CODED BACK AGAIN 
♦DEFINE POLE = -34 . 724 1 36 , 986 . 55566 , TS 

♦DEFINE POLE 1 = -97 . 537277 , 794 . 43249 , TS 

♦DEFINE POLE 2 = -1 39 . 363952, 438 . 9 1845, TS 

♦DEFINE POLE 3 = -1 55 . 34062 1 , . 00000000 , TS ; REAL 

* 

* 

♦REM P 3 I MUST LOOK AT FIRST THREE STAGES NEXT 

1 POLES/ZEROES REMOVED 

* 

♦ EVALUATE LOG< MA G AI H >/'LOG< 2 > ; SCALING FACTOR NEEDED BEFORE THIRD STAGE 
1 .22287941*10**1 

* 

*J UE HAVE ALREADY SCALED BY 2**12 SO ANOTHER 2**3 UILL SUFFICE. 

♦ 

♦APPEND iFliCODE.SRC '1 SCALE INPUT TO POLE 2 UITH RIGHT 3 SHIFT' ; HAKE NOTE 

* 

♦REM P i REMOVE POLES 

3 POLES/ZEROES REMOVED 
* 

♦INCLUDE :F1 : AFTER. THP J GET OUR FILTER AS CODED BACK AGAIN 

*D£F1N£ POLE = -34. 724136, 986. 55566, TS 

♦DEFINE POLE i = -97 . 537277 , ?94 . 43249 , TS 

♦DEFINE POLE 2 = -1 39 . 363952, 438 . 9 1845, TS 

♦DEFINE POLE 3 = -1 55 . 34062 1 , . 00000000 , TS i REAL 

♦ 

* 

♦EVALUATE L0G< MAG AI H )/L0G( 2 > ; SCALING FACTOR NEEDED BEFORE FOURTH STAGE 

1 . 33596049*10^1 

♦ 

*i UE HAVE ALREADY SCALED BY 2**15 SO NO FURTHER SCALING IS NEEDED. 

* 

♦ APPEND iFl :CODE .SRC ' ; NEEDN"T SCALE INPUT TO POLE 3' J MAKE NOTE 
♦ 

♦ i THE FILE iFUCODE.SRC NOy CONTAINS THE FINAL CODE FOR OUR FILTER EXCEPT 
* 

*; FOR THE SCALING <UHICH IS INDICATED ONLY BY COMMENTS) AND THE INPUT 

♦ 

♦i AND OUTPUT ANALOG SECTIONS. THESE CAN BE ADDED BY EDITING THE FILE 

* 

*} MANUALLY. UITH CARE IT IS POSSIBLE TO AVOID THIS EDITING STEP AND CREATE 

♦ 

♦; THE FINAL SOURCE CODE FILE HERE. 
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♦GRAPH STEP ; JUST OUT OF CURIOSITY LET'S LOOK AT THE STEP RESPONSE 

STEP ! A A * A * A A ...... ' 

10395 -" .--. 

9900 - ' .' '--....--"• 

9405 ' .-"-. 

8910 ' - . -. .' 

8415 - - 

7920 ' ' — ' 

7425 

6930 

6435 

S94 

5445 

4950 

4455 

3961 

3466 

297 1 ' 

2476 

1 98 1 

1486 
991 
496 



AM PIS EC ! A A A A A A A A ! 

0.0000 0.001 0.0015 0.002 0.0025 0.003 0.0035 0.004 0.0045 0.0052 



♦ J RISE TIME IS ABOUT A MILLISECOND AND FINAL AMPLITUDE IS ABOUT ONE THIRD 

* 

*; OF OUR TOTAL SCALE FACTOR 2**15 (ABOUT 32K>. 



♦EVALUATE 2**15 S ABOUT 32K 

3 .2767984*10**4 



♦EXIT ; THAT'S ALL FOR TODAY 
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CHAPTER 2 
LANGUAGE ELEMENTS 



Introduction 

The SPAC20 software provides you with an easy-to-use English language command 
set for controlling SPAC20 execution in a variety of interactive functions. 
Commands are keyed in one line at a time, each ending with a carriage-return, and 
are more fully discussed in Chapter 3. The current chapter deals with the more 
elemental components of the Compiler language, the building blocks out of which 
expressions and commands are later created. 

An example of one complete SPAC20 command is shown in Figure 2-1. This 
command is made up of separate tokens or mnemonic codes (character 
strings): DEFINE, POLE, etc. Each of these tokens provides a particular element 
of information necessary to inform the SPAC20 Compiler of the specific action to 
be taken. Table 2-1 defines the function of each of these tokens. Every SPAC20 
command is composed of one or more such tokens. 



DEFINE POLE 12 = -10, 250, TS 



Figure 2-1 . Example of a DEFINE Command 



121533-44 



Table 2-1 . Token Functions in the Above Command 



Token Number 


Name 


Function 


1 


DEFINE 


Command keyword; causes definition of some 
object, in this case a pole 


2 


POLE 


Object keyword; names a type of object to be dealt 
with in this command 


3 


12 


Constant token; used here as the label of the pole 
being defined 


4 




Operator token; indicates creation or replacement 
of the object to its left using the values given to its 
right 


5,6 


-10 


Unary operator and constant token; denotes 
decimal negative ten 


7 


■ 


Punctuation token; separates other tokens, here 
-10 and 250 and TS 


8 


250 


Constant token; denotes decimal two hundred fifty 


9 


, 


Punctuation token as above 


10 


TS 


Modifier token; indicates which plane (of three) is to 
contain the pole or zero (i.e., sampled S-plane TS as 
opposed to either CONTINUOUS or sampled 
Z-planeZ.) 
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This command defines a sampled pole, labeled 12, at X-Y coordinates (-10), (250) 
in TS (the sampled S-plane whose sample rate you would have set earlier in a 
separate command). 

Thus, the SPAC20 command language is composed of a character set and 
vocabulary of mnemonic tokens. The character set is used to construct mnemonics 
and, in turn, the mnemonic tokens are used to construct SPAC20 commands. 



Character Set 

The valid characters in the SPAC20 command language include upper- and lower- 
case alphabetic characters A through Z and the set of digits through 9. The space 
serves to indicate the end of a token, and carriage-returns or line-feeds are used for 
delimiting (ending) command input lines. The question mark [?], at-sign [@], 
underline [ ], and dollar sign [$] are also valid in user-defined names. 

Other valid characters are the ASCII (American Standard Characters for 
Information Interchange) algebraic operators [+] and [-] (binary and unary), 
asterisk [*], slash [/], relational operators [=,<,>,], ampersand [&], semicolon [;], 
period [.], parentheses [(,)] and comma [,]. Special characters listed below are valid 
in certain contexts. All other characters are ignored unless occurring within 
comments or strings, as discussed below. ESCape interrupts processing and is not 
legal within a command. 

Alphabetic characters are: 

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz 
Numeric characters are: 

01234567 8 9 ABCDEF (last six only allowed as hexadecimal digits) 
Special characters are: 

+->=<$' &).(,/;?*_a:% 

This character set is used to construct the vocabulary that constitutes the command 
language. The special characters, explained briefly below, are discussed more exten- 
sively where they are directly relevant, e.g., in user names or expressions. 

Special Character Usage 

A semicolon that is not included in a string (defined below) causes the semicolon and 
the rest of the current input line to be treated as a comment. Blank lines are allowed 
and ignored, i.e., lines containing only a carriage-return (CR), a line-feed (LF), or 
both (CRLF). Ampersands outside of comments or strings permit input command 
lines (Chapter 3) to be continued on the next input line. The other special characters 
above have meaning in numeric expressions, discussed later in this chapter and in 
Chapter 9. An example of a comment is 

DEFINE POLE8 = 0, 100; at100Hz 

The special characters [ @, , and ? ] are allowed in user names (Chapter 3), as in 

@POLE_12 or ?WHICH_INCREMENT. Dollar signs embedded within user- 
names or constants are ignored but echoed as input, providing visual separation as 
in the name FILTER$ONE$G AIN . 
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Tokens 

A token in SPAC20 command language is roughly equivalent to a "word" in the 
English language. It consists of a string of alphanumeric or special characters, 
sometimes augmented by the one-character prefix (period) that serves to identify 
user-symbols. 

All SPAC20 mnemonics are referred to as tokens or special tokens. Tokens 
encompass identifiers, strings, keywords, and numeric constants (integer and 
floating point). Special tokens include relational operators, arithmetic operators, 
logic operators, and punctuation. 

The following special-character sequences are tokens in the SPAC20 command 
language: 

+ - = > . < , )*(/<=>=<>** 



Example: 

.A+.B PI >= ( .X + .Y/HPI) <SIN(2*PI*.FREQ))**2 



Their uses as operators and punctuation are discussed further in later sections on 
arithmetic and logical expressions. 



Identifiers 

You create an identifier as a sequence of alphanumeric characters, at-signs, question 
marks, and underlines. The first character of an identifier must not be a digit. (or 
dollar sign). Only the first 31 characters of an identifier or constant are significant, 
and additional characters are ignored. 



Strings 



A string is a sequence of characters preceded by an apostrophe (') and extending to 
the next apostrophe. Any character, printing or non-printing, is allowed in a string. 
A doubled apostrophe embedded in a string denotes the use of one apostrophe as 
part of that string, rather than the end of the string itself. 



Examples: 

'This is a string of 33 characters' 

WRITE 'This string of 54 characters gets sent to the con sole. ' 

'This 56-character string isn' 't c omp Lex, don' 't you agree?' 

(When a macro is invoked (called) with an actual-parameter that includes a comma 
or a quote, the entire parameter must be sent as a string, i.e. preceded and followed 
by a quote, and the quotes within must be doubled [see Chapter 9]) 
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The SPAC20 Compiler recognizes a fixed list of predefined tokens called keywords, 
divided loosely into four classes: commands, objects, modifiers, and 
constants/operators/functions. Most of these have short abbreviations, and none 
are checked for spelling beyond the first 3 characters. Here is a partial list of 
keywords: 



Commands 


Objects 
(Notel) 


Modifiers 


Constants, 


Operators, 


Functions 


APPend 


AGAin 


*MSQe 


AT 


HPI 


MASK 


COS ACOS 


CODe 


*BOUnds 


PERror 


AUTo 


PI 


** 


SIN ASIN 


COUnt 


*ERRor 


PHAse 


BY 


TPI 


* 


TAN ATAN 


DEFine 


FSCale 


POLe 


THRough 




/ 


EXP LOG 


Display 


GAIn 


PZ 


TO 




+ 


SQR 


EVAIuate 


GERror 


STEp 


ON 




- 


ABS 


EXIt 


GREf 


SYMbol 


OFF 




MOD 




GRAph 


GROup 


IS 


Z 








HELp 


IMPulse 


UBOund 










HOLd 


*INSt 


XSIze 










INCIude 


LBOund 


YSCale 










LISt 


MACro 


YSIze 










MOVe 


*MAGain 


ZERO 










OGRaph 


*MERror 












PUT 














REMove 














WRIte 















(The complete list, including definitions, appears in Appendix B.) 



Note 1 : If you enter any object name as a command, the current value(s) will be 
displayed. The underlined words may be read or written (changed); the other objects 
either require additional keywords (discussed in later chapters) to manipulate them, 
or are functions computed by SPAC20, or are read-only (indicated by a single 
asterisk to their left). 



* read-only. 

The table below shows a different view of these keywords. 





Scalars 


Non-Scalars 


Changeable 


XSIZE 
YSIZE 
TS 


LBOUND 
UBOUND 
FSCALE 
GREF 


Non- 
Changeable 


ERROR 

INST 

MAGAIN 

MSQE 

MERROR 


AGAIN 

GAIN 

GERROR 

PHASE 

GROUP 

STEP 

IMPULSE 
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Scalars have single numeric values. Non-scalars have either multiple numeric values, 
like GAIN and PHASE, or non-numeric values, like GREF and LBOUND. The 
scalars comprise a category of keywords usable in expressions as well as in display 
commands: keyword references. This category is discussed further later in this 
chapter, and used in the examples of Chapter 10 and 11. 

Examples: 

TS = 1/13020 

GREF = 1 AT450; reference gain i s 1 dBat450Hz 

LBOUND = 10AT500, 20AT1500; lower bound on gain islOdBat 500Hz 

; rising Linearly indBagainst a log f scaleto20dBat 1500 Hz (see 

; Chapter 5) 

In the command 

MOVE POLE 12 BY .DELTA_REAL, .DELTA_IMAG 

MOVE is the command keyword, POLE is an object keyword, and BY is a modifier 
keyword. The token "12", a constant, is seen by context as a label identifying which 

pole is to be moved. The tokens .DELTA REAL and .DELTA IMAG are 

recognized as user-defined symbols by the presence of the leading period. 

The scalar keywords are called keyword references. They are used to display, or 
access in expressions, all of the scalar numeric-valued system variables. They are 
used in three ways in SPAC20 Compiler commands: 

• When one appears in an expression, the value used or displayed is the contents 
of the referenced object at the time the expression is evaluated. 

• When one appears alone for display, its current contents are displayed. 

• When one appears on the left side of "=", indicating a change, the contents of 
the referenced object are set to the current value of the expression on the right 
side of the "=". if the value on the right represents an illegal value for the 
referenced object, an error is reported instead. For example, TS=-3 would 
result in an error because a negative sampling-interval is meaningless. 



Keyword 
Reference 


Brief Description 


Read/Write Status 


Integer/Floating Point 


TS 


Sample time (in seconds) for 
poles and zeros in TS plane 


Both 


Positive floating point 


XSIZE 


Width of console display 
screen 


Both 


12 <= integer <= 79 


YSIZE 


Height of console display 
screen 


Both 


4<= integer <= 25 


MAGAIN 


Maximum AGAIN (absolute 
gain) considered over the 
frequencies on FSCALE 


Read-only 


Positive floating point 


MSQE 


Mean square error in gain as 
compared to gain bounds, 
considered over the frequen- 
cies on FSCALE 


Read-only 


Positive floating point 


MERROR 


Maximum absolute error in 
gain as compared to gain 
bounds, considered over the 
frequencies on FSCALE 


Read-only 


Positive floating point 


INST 


Number of AS2920 
instructions generated by 
most recently entered CODE 
command 


Read-only 


Positive integer 


ERROR 


Signed error in multiplier 
from last CODE command 


Read-only 


Floating point 
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TS has initial value 0. This value cannot be legally entered from the keyboard, and 
thus indicates that you have not yet specified an actual value. TS must be assigned a 
value before it is used, that is before any sampled (in TS or Z- planes) poles or zeros 
are created. An error will also be issued if it has not been assigned a value when it is 
needed in any other context, e.g., in calculating a filter response like IMPULSE or 
STEP, or when turning HOLD ON (see Chapter 5). 



User Names 



'( • j *~C identifier J- 



Symbolic Reference Chart 121533-0* 

The command language permits you to use symbolic (as opposed to numeric) 
references to variables and constants through the use of these names. 



Symbols you create are stored in a symbol table. One way you can create a symbol is 
by using the DEFINE command, e.g., 



DEFINE .THETA 4 = 2 . 71 8281 *4*P I 



(The full syntax for DEFINE appears later in this chapter.) Other methods will be 
covered in later chapters. Symbols can be DEFINEd or REMOVEd from the symbol 
table. 



A user symbol preceded by a period is called a symbolic reference. When a symbolic 
reference appears as part of a command, its value is taken from the symbol table. It 
may be used anywhere such a value is valid, e.g., a floating point value may not be 
used where an integer is required. 



There may be intervening spaces between a period and the identifier following, but 
they are not part of the symbol. 



When you initialize the Intellec system with the SPAC20 module, you can restart a 
prior design session. You do this by INCLUDing the file of commands and 
parameters you earlier created using a PUT or APPEND command (see Chapter 8). 
By typing such an INCLUDE, you can get back the symbol table used in that earlier 
session (as well as certain other parameters you also sent to that file, by name or by 
default as described in Chapter 8). 



You can add symbols to the symbol table, or remove any or all symbols currently 
stored there. The SPAC20 symbol table therefore contains symbols INCLUDEd or 
DEFINEd but not yet REMOVEd. 

Examples of user-defined identifiers (user-names): 

.VAR123 .GAN1 .FAZ23 .VAR66 .ERR3INST3 
.F OF T 3 P1 .F$T$3ZER$3 .3MYFLAG 
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Numeric Constants 



Ol 



o 1 



-I system constant J >- 

(unsigned "\ 
decimal 1 ^- 
constant J 



unsigned 
-*-( hexadecimal 
constant 



(unsigned "\ 
binary 1 * 

constant J 



-f hex-digit y- 



o 



1 



^ >GEE> 1 T GEE ^ 



'-Q-* 



unsigned hexadecimal constant 
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numeric constant 



121533-06 



A constant is a token that represents a fixed numeric value. The SPAC20 compiler 
recognizes numeric constants, including floating point constants, as well as the 
system constants named above. A numeric constant is assumed decimal unless it 
carries an explicit suffix of H (for hexadecimal) or B (for binary). An explicit suffix 
of D means decimal. If a constant contains characters invalid in the designated 
number base, it will be flagged as an error. 



Examples of valid numeric constants: 



12AH 

12D 

1 01 1 01 1 B 

0.1111$1111$1111B 



'12A' is valid in hexadecimal 
'12' is valid in decimal 
'1011011' is valid in binary 
dollar signs are ignored 



2.71828 
31.4159 
A.2CFH 
.001 B 



Examples of invalid numeric constants: 



12AF 



12AD 



101A2B 



2AD6H 

1 .B 
13. 
E.4C 



Hexadecimal digits used 
without an H suffix, hence 
invalid in the default (decimal) 
interpretation. 

Here the final D could be a 
suffix but the A is not a decimal 
digit. If hexadecimal is intend- 
ed, a final H is necessary. 

'A' and '2' are not valid binary 
digits. If hexadecimal is intend- 
ed, a final H is necessary. 

'G' is not a valid hexadecimal 

digit. 

Needs to be1.0Bor1.BH 

May not end with point 

Needs suffix H 



~Q digit ") U. 



»OyC53*r-^©-^ 



unsigned decimal constant 
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>©- 



unsigned binary constant 



All numeric values are stored internally as Intel-standard-format single precision 
floating point numbers, positive or negative, ranging in magnitude from 
1 .2*10**— 38 to 3.4*10**+38. They have mantissas with 24-bit precision. Manual 
number 9800452, entitled 8080/8085 Floating Point Library, discusses this standard 
format. 

A numeric constant may appear as (or contain) a point followed by a fractional part. 
(It may not end with a point only.) However, a leading zero is needed in the case of a 
hexadecimal constant like .FFH, which would otherwise be interpreted as a symbolic 
reference whose value is to be taken from the symbol table. Constants like O.FFH or 
.2FFH will not be interpreted as symbols. 

Dollar signs ($) are allowed within numbers and are ignored. 
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Arithmetic Expressions 





' 


' 


r~G>~ 


* 


, 














1 t "\ 








i 


1 


















p< * >* 


f MASK ") 










— ( / >~ 










' 


' 


► £ MOD }— ► 


' i 


' 



An integer-expression is an arithmetic-expression which 
evaluates to an integer. 



Arithmetic Expression 
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An arithmetic expression is a construct of numeric-valued operands and operators 
that evaluates to a numeric-value. (The fully general definition of expressions is not 
needed until Chapter 9, where it appears.) 

The SPAC20 Compiler evaluates expressions in a left-to-right scan modified by 
operator precedence, following an algebraic sequence in the form: 



operand [operator operand]. . . 



Operators and operands are explained below. Examples of arithmetic expressions 
include 



5 + 7 .AVAR1*.AVAR2 < . BVAR1 + . CVAR5) / ( . AVAR1 + . AVAR2.*7> 

Primaries are a restricted set of expressions, whose charts appear later in this 
chapter. 



Operators 

Operators are used in expressions and in commands. A summary of SPAC20 
operators is shown below. The binary (arithmetic) operators are listed in their group 
order of precedence from highest precedence to lowest, i.e.,** has highest 
precedence, MOD, *, and / have equal precedence higher than + or -, which have 
equal precedence. MASK, which gives bitwise conjunction of two quantities, has 
lowest precedence. When several operators of the same precedence appear in an 
expression, they are evaluated left to right. Expressions in parentheses are evaluated 
first, before any external operators are applied. 
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Type 


Operator 


Interpretation 


Precedence 


( ) 


Controls order of evaluation 


Binary (arithmetic) 








** 


Exponentiation 




/ MOD 


Remainder 

EXAMPLES: 5 MOD 3 = 2; 
10MOD3 = 1; 


same precedence * 




15MOD3 = 




* 


Multiplication 




, ' 


Division 




( ♦ 


Addition 


same precedence < 


' 


Subtraction 




[mask 


Bitwise AND 

EXAMPLES: 1.011 B MASK .1B = O.OB 

1.011BMASK.111B = 0.011B 


Unary-op 


+ 


single positive quantity 




- 


single negative quantity 



Operands 

Operands are numeric values, and have the general forms shown below. These are 
the "primaries," which are allowed as restricted expressions in later discussions of 
SPAC20 commands. 



Examples 



[unary-op] numeric constant 
symbolic reference 
keyword reference 
function(expression) 
(expressions) 

frequency response function 
coordinate (p/z-expression) 



+4, -PI, HPI, 2.71 

.ALPHA, .BETA_1 

TS, XSIZE 

SIN(45/PI),SQR(.XVAR) 

(EXP(-.A*.TIME)*SIN(2*PI*.FREQ1) 

GAIN(60), PHASE(.25/TS) 

REAL (POLE 12), IMAG (ZERO 9) 



The functions referred to above are a familiar group: sine, cosine, tangent, arcsine, 
arccosine, arctangent, square root, absolute value, and the natural powers and logs 
(to the base e = 2.718281...). They may appear anywhere a floating point value is 
appropriate. They are evaluated, in a left to right scan of the complete expression, 
subject to the precedence hierarchy explained above. Their arguments, within 
parentheses, are of course evaluated before the function is computed. 

The last operand in the list above, "coordinate (p/z expression)," represents a set of 
four functions: REAL, IMAG, RADIUS, ANGLE. These return the real or 
imaginary coordinate of a pole or zero defined in the S-plane, or the radius or angle 
of a pole or zero defined in the Z-plane. The angle is always assumed in radians. 
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Partitions 












— -c 


integer 
expression 


^ 




) 

Partition 


THROUGH int-exp \- *J 
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Partition refers to a range of poles or zeros. It is specified in the form 
arithmetic-expression 



or 

arithmetic-expression [THROUGH arithmetic-expression] 

which will cause a command to affect all poles or zeros (whichever is specified) that 
fall in the range. Each expression is evaluated to a number, and the two numbers 
designate the range. 

Example: 

REMOVE POLE 1 THROUGH 13 

This command will remove all poles numbered from 1 to 13 (inclusive) from the table of 

currently-defined poles (see Chapter 4). 

Charts for Primaries 

The charts below show the names and forms of all items usable as primaries, i.e., the 
set of restricted expressions permitted where the word "primaries" appears in a 
syntax chart. 



c 



c 



c 



c 



c 
c 



c 



numeric constant 



symbolic reference 



keyword reference 



function (expression) 



filter response (expression) 



(expression) 



"> 



> 
> 



> 



y 



> 



► I coordinate (pole/zero-expression) 



> 



*2,5 



*2,9 



* chapter where discussed 



Primaries 
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CE> 



C XSIZE > 



-+~f YSIZE } *> 



-►f magain) ► 



■+-Q MSQE^- 



~[ MERRORJ- 



-*~Q_ INST ^ *" 



~f ERROR \ 



Keyword Reference 
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"*V * J *"C ,dentl,,er J~ 

Symbolic Reference 
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~^C sin 3~ 

-► ( asin y - 

-»>( COS ^~ 

-►f ACOS V 

-» C TA " > 

-*~f ATAN V 

"»* C EXP J ~ 

^ C L0G > 



EXPonentiation and LOGarithms 
to the base e = 2.718281 



Functions 
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►( GAIN J ► 



frequency 

response 



-►(^ AGAINJ- 



fr-(^ GROUP J- 



-►(^GERRORJ ► '- 



-*~^ PHASE ^ »« 



time 
response ' 



*GED — *} 

-»►( IMPULSE^ **' 



Filter Responses 
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U p^ry -^~ 



■ -— (primary) - 



-Ci> 



-»-( mod' 



GE*j 



•c 






-*CZD- OS 




cId 



Expression 
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c 



REAL 



.»►( IMAG 



> 



-►(angle \ 
-*~q radiusj- 



O 



■ ( roLE > 



c 



M ZERO 



-(jnteg 



er expression 



5 — -Q^ 



Coordinate (Pole/Zero Expression) 
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r^C 



On 



G>J 



►I system constant 



(unsigned "\ 

decimal 1 ► 

constant J 

(unsigned "N 

hexadecimal I ► 

constant y 

(unsigned "N 
binary j » 

constant J 



numeric constant 



CED-i- 



QEZM 

system constant 



digit 



>L, 



q—^^JTqT 



unsigned decimal constant 



-C hex-digit y- 



o 



— ( * )~»»C dec digitj — i k ■ » ^hex digit^ «» 



;:-0- 



unsigned hexadecimal constant 



Or 



O 
O 

L(7> 



:h3>* 



unsigned binary constant 
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CHAPTER 3 
INTRODUCTION TO SIMPLE 

COMMANDS 



The SPAC20 capabilities described in the Preface are reflected in the Compiler 
commands, constructed from the elemental units discussed in Chapter 2. The 
SPAC20 Compiler accepts as input both simple and compound commands. Simple 
commands are discussed in Chapters 3 through 8. Compound commands use 
sequences of simple commands, combined with control commands which determine 
the flow of control, i.e., branching and looping. Compound commands are 
discussed in Chapter 9. 

This chapter describes the structure of commands and the procedure for typing them 
in for execution. It then introduces the simplest commands: those which define, 
change, or display the values of symbolic objects. 



Entering and Editing Command Lines at the Console 

The SPAC20 Compiler displays an asterisk prompt (*) at the left margin when it is 
ready to accept a command from the console. 

You enter commands (one or more tokens) through the keyboard, terminating each 
with a carriage return [CR] (or a line feed [LF]). The system then executes the 
command. 

Tokens in the command are separated by blanks unless the construct requires 
another form of separator. For example, tokens in a list are separated by commas; 
in this case, blanks may be inserted for clarity but are not required. 

An input line may include comments. A semicolon (;) must precede the comments. 
If the input line contains any portion of a command, this must precede the 
semicolon, for characters in a comment are not interpreted by the Compiler and are 
not stored internally. The main use of comments is to document a design or code 
session while it is in progress. This is particularly useful when executing compound 
commands or running the Compiler under the ISIS-II SUBMIT facility. 

ISIS-II limits input lines to 120 characters maximum. Commands longer than this 
can be broken up into more than one input line by entering an ampersand (&) just 
prior to the line terminator. (The & must not be contained in a comment or string.) 
The system acknowledges continued lines by prompting with two asterisks (**). 
Characters between the ampersand and the line terminator are ignored, and the 
ampersand is treated as a space. 

You can use ISIS-II editing capabilities to correct errors in the current input line. 
Once a line terminator (carriage return or line feed) has been entered, that line can 
no longer be edited. 

The line-editing characters are as follows: 

Characters Results 

RUBOUT Deletes last character entered in current input line. The deleted 

character is echoed immediately. (However, in the latest versions 
of ISIS-II the cursor backs up over the offending character, deleting 
it from view.) The RUBOUT function can be repeated, deleting one 
character each time it is pressed. 
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CTRLX 
CTRLR 

ESC 

CTRLP 

CTRLS 

CTRLQ 

Carriage 
Return 

Line Feed 



Deletes entire current input line. 

Displays entire input line as entered so far. This is useful after a 
RUBOUT, to review which characters have been deleted. 

Cancels entire command being entered or executed. 

Inputs next character literally. 

Stops display temporarily. 

Continues display interrupted by CTRL S. 

Terminates input line or command line; if command, begins 
processing. 

Terminates input line or command line; if command, begins 
processing. 



Setting or Changing Symbol Values: Equal Sign, 
DEFINE, REMOVE 



The Change Commands 

*-f TS = 



c 
c 



c 



c 



c 



c 



rC 



C 



symbolic reference ■ 



> 
> 



>^ 



> 



> 



> 



>^ 



> 



> 



' chapter where discussed 



-c 



> 



c 



^-1 expression, expression 



> 
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When a user-name preceded by a period appears in a command, it is called a 
symbolic reference. The value of any symbolic reference or any writeable keyword 
reference may be changed by entering the reference to be changed on the left side of 
an equal sign (=), followed by the new value on the right side. If the keyword 
reference is read-only, as mentioned in Chapter 2, you get an error. 
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Examples: 

TS = 1/13020 
.ALPHA = 4.4 

.BETA_1 =EXP(.ALPHA/TS) ;= 2.718281 ** (4.4/13020) 

.BETA_2 = -.BETA_1 * EXP (2*. ALPHA) 

•ERRSSAVE =0.5 

.0RIG_P0LE_1_REAL = 

.0RIG_P0LE_1_IMAG = 100 

(The examples above assume that the symbolic references used (e.g., .ALPHA) are 
already defined, as discussed in the next section. Otherwise these change commands 
would be rejected by the Compiler as errors.) 

XSIZE = 55 ;graphcoL umn s; seeChapter6 

YSIZE = 22 ;rows 

UBOUND = 500 AT 1500 ;dBatHz(Chapter5) 

FSCALE = 100,500,1500,4500 ; i n He rt z ( C hapt e r 6) 



The DEFINE Command for Symbols 
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The DEFINE command places the symbol you supply into the SPAC20 Compiler's 
symbol table, and associates with it the floating point value of the expression you 
give with it. This symbol table value remains fixed until you issue a change 
command. Symbolic integers are recognized when used where needed (e.g., as pole 
labels) despite being stored as floating point values. If the symbol already exists, you 
get an error. (However, you may change the value of an existing symbol by the 
change command, as above.) 



Examples: 

DEFINE .GAIN_P0LE_0NE = GAIN(60) 

DEFINE .P0LE_TW0_GAIN = 2. 34 

.GAIN_P0LE_0NE = 0.78 

DEFINE .RADIUS_P0LE_8 = RADIUS (P 8) 

DEFINE .ANGLE_P0LE_8 = TPI*.FREQ*TS 
; for lateruseast emp orary storage for 
pole8 coordinates, z plane. 
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The REMOVE command keyword followed by a symbol in the table causes that 
symbol to be deleted from the table. REMOVE may also be followed by a list of 
symbols, separated by commas, or the object keyword SYMBOLS, which causes all 
symbols to be deleted from the table. This does not, of course, affect system-defined 
keywords. 

REMOVE .GAIN_P0LE_0NE 

REMOVE .P0LE_TW0_GAIN 

REMOVE .RADIUS_P0LE_8, . ANG LE_P0 LE_8 

REMOVE SYMBOLS 



Displaying Object Values 



The current value defined for keyword and symbolic references may be displayed by 
entering the reference as a command; i.e., followed immediately by a line 
terminator. Its value will be shown on the next line. 

Entering the keyword SYMBOLS as a command causes every symbol in the symbol 
table to be displayed with its associated numeric value. 

The EVALUATE command displays the decimal value of the expression you enter. 
This command can be used as a keyboard calculator to compute the value of any 
arbitrary expression. For example, 

EVALUATETPI 

will display the value 6.2831852. 
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CHAPTER 4 
POLE AND ZERO HANDLING 



Planes and Coordinates For Poles and Zeros in 
DEFINE, MOVE, REMOVE Commands 

When you define the location of a pole or zero, you may do so in one of three ways: 

• in the Z-plane, giving its radius and angle (in radians), 

• in the S-plane, 

• or as a Z-plane pole or zero which is defined by an equivalent S-plane location 
using the matched Z transform. The sampled S-plane specification is TS, as 
described in the next section. 



The Compiler maintains a table of all poles or zeros currently defined. Continuous 
filter sections are presumed to be implemented outside the 2920 processor, and if no 
plane is specified, CONTINUOUS is assumed. Being able to combine sampled and 
continuous sections allows you to evaluate the effect of external anti-aliasing filters. 

Sampled poles and zeros are created or moved in the S- or Z-plane, using the 
predefined units and coordinates specific to that plane. This means if the plane 
specified is Z, the coordinates you give are used as the radius and angle (in radians) 
which locate that pole or zero in polar coordinates. 



If the plane specified is not Z, then the Cartesian coordinates you give are used as 
the real and imaginary part of that pole or zero. S-plane units correspond to Hertz. 



Sampled S-plane poles or zeros are actually mapped to the Z-plane during calcula- 
tion, using the matched Z-transform, i.e., a pole or zero at X + jy on the S-plane is 
transferred to a pole or zero at e 2nTS ( x+ Jy) on the Z-plane, where TS represents the 
sample interval in seconds. In polar coordinates, this Z-plane location is (e 2nTSx , 
27iTSy). 



NOTE 

One consequence of choosing the TS plane is that the frequency at which a 
pole or zero is defined is fixed and independent of the sampling interval. 
Doubling the sample rate has no effect on the frequency. Different 
sampling rates will, however, cause different geometric coordinates when 
such a pole or zero is mapped to the Z-plane, and different 2920 code to im- 
plement the filter. 

Conversely, defining a pole or zero in the Z-plane fixes the geometry, i.e., 
the radius and angle. The frequency, however, depends on the sample rate. 
Doubling the rate (halving the interval) doubles the frequency represented 
by the fixed polar coordinates. 

For example, suppose POLE 1 in Z has polar coordinates 1 .00, PI/4, with 
the sample interval set at 1/5000 seconds. This implies a frequency for 
POLE 1 of 5000/8, or 625 Hz. If the sample interval is halved to 1/10000, 
the geometry of the pole in the Z-plane is unchanged, but its frequency 
doubles to 1250 Hz. An equivalent pole specified in the TS plane keeps the 
same frequency regardless of sample interval. 



4-1 



Pole and Zero Handling 



SPAC20 Compiler 



Thus the three possible terms used for specifying the plane in a DEFINE (or MOVE) 
command are CONTINUOUS, TS, and Z. If no plane is given, then the default (or, 
for MOVE, a prior specification of plane) is used. Further, the pair of expressions 
used in DEFINE (or MOVE) indicate the coordinates of (or increment for) the pole 
or zero. These expressions will be taken to mean either real part and imaginary part 
(for S-plane), or radius part and angle part (Z-plane). The charts and discussions 
below will show all of these forms. 



The DEFINE Command For Poles and Zeros 
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The DEFINE Command for Poles and Zeros 



As shown in the syntax chart above, defining a pole or zero begins with the 
command keyword DEFINE and the appropriate object, POLE or ZERO. The next 
token is usually the number to be used as the label for this pole or zero. However, 
the token may in fact be any valid arithmetic expression as discussed in Chapter 2. 
(For this use as a label, the expression must evaluate to an integer.) 

Following this "label", an equal sign is required, leading to the two expressions 
which define the location of the pole or zero, separated by a comma. Usually these 
will simply be numbers, i.e., the real/imaginary or radius/angle coordinates specify- 
ing the desired location. However, any legal expression may be entered (see Chapters 
2 and 9). As mentioned above, angles are always taken as being in radians. They 
must be greater than -PI and not greater than +PI. Radii must be non-negative. 

The syntax chart next indicates that no further tokens are required, but you have the 
option of specifying the plane. To do so, you must enter a comma after the second 
coordinate-expression, and then pick one of the three choices shown. 

Up to 20 poles or zeros can exist at one time, e.g., 12 poles and 8 zeros or 5 poles and 
15 zeros, etc. Their numeric labels are arbitrary, that is, you may define them using 
whatever numbers you choose, in any order, e.g., 1, 5, 88, 13, 46, 22. The number- 
ing scheme has no effect on later calculations, but you may wish to assign mean- 
ingful labels, particularly if you wish to manipulate them later with compound 
commands. 



NOTE 

The only effects of a chosen numbering scheme will appear when a partition 
is used, as discussed in Chapter 2, or if you need to see the individual effect 
of each pole or zero, which will be discussed in Chapter 5. (As a brief parti- 
tion example, if you defined poles in the above order and later displayed the 
first few by typing POLES 1 THROUGH 20, only poles 1, 5, and 13 would 
be printed out.) 
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Each complex pole or zero represents a conjugate pair so that the filter can be 
realized. That is, during calculation a conjugate pole or zero is assumed to exist for 
each pole or zero with a nonzero imaginary part. 

Conversely, a continuous pole or zero is considered real if its imaginary coordinate 
is zero. A sampled pole or zero is considered real if, after mapping to the Z-plane, its 
imaginary coordinate is zero. Thus a pole at -5,0.5/TS,TS is considered real 
because, at half the sample rate, it maps onto the real axis in the Z-plane. 

Poles and zeros are numbered independently and uniquely. You may not DEFINE a 
new pole or zero numbered the same as an existing object of the same type. That is, 
if POLE 1 exists and ZERO 1 does not, you may say DEFINE ZERO 1 but not 
DEFINE POLE 1 . (However, you can MOVE or REMOVE it as shown below.) 

Examples: 

DEFINE POLE 1 = 0, 100, TS 

DEFINE ZERO 1 = -3, 5, TS 

DEFINE POLE 2 = -1 0, 450 

DEFINE ZERO 2 = -16, 

DEFINE POLE .GAMMA = 0.67, PI/6, Z 

; these 2 ex amp L es assume that .GAMMA has been previously defined 

; as an integer value. 

DEFINEZERO .GAMMA=0.55, PI, Z 

(Poles and zeros defined in the Z-plane must have radius >= and an angle which 
conforms to -PI < angle <= PI) 
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To remove one or more poles or zeros from the table, you must enter REMOVE 
followed by one of three object keywords. PZ means all poles and all zeros are to be 
removed, and no further tokens are needed for this command. If POLE or ZERO is 
entered with no further tokens, then all poles (or zeros) are removed. If there is a 
next token, it represents the first pole or zero to be removed. If the command is 
terminated here, only that pole or zero is removed. 

It is also possible to remove a range of poles and zeros by using a partition, i.e., by 
following the first pole or zero with the token THROUGH and the label of the last 
pole or zero to be expunged. Usually the token identifying the intended pole or zero 
is simply an integer, but it is valid to use any legal arithmetic expression to specify 
which one is meant. (In this context, however, the expressions must evaluate to an 
integer. The terms partition and arithmetic expression are discussed in Chapter 2.) 
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Each time REMOVE is used, a message is displayed giving the number of poles or 
zeros actually deleted. Once a pole or zero has been removed, its numeric label can 
be reused in defining a new pole or zero. 

REMOVE POLE 1 

REM0VEZER01 

REMOVE POLE 2 THROUGH 10 

REMOVE ZERO 2 THROUGH 5 

REMOVE PZ 

REMOVE POLES ; spel Li ng i s not checked beyond 3 characters 

REMZERoes 
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The MOVE command contains similarities to both the DEFINE and REMOVE 
commands. Its objects are the same as those for REMOVE, and its modifying 
phrases are similar in form to those for DEFINE. 

After entering the command keyword MOVE, you must choose one of the three 
object keywords shown. PZ means all poles and zeros are to be moved using the 
modifying phrases which follow. The object POLE (or ZERO) allows you to specify 
one or a range of poles or zeros to be moved, using a partition. If POLE (or ZERO) 
is entered with no further tokens, then all poles (or zeros) are moved as directed. 

The modifying phrase 

BY expression, expression 

specifies an increment for each of the coordinates originally defined for this pole or 
zero, in the units appropriate to that plane. That is, if this pole or zero is continuous 
or sampled in TS, these increments are to the real and imaginary parts respectively. 
If the original pole or zero specification was in Z, then these increments are to the 
radius and angle, respectively. The new Z-plane position must satisfy RADIUS >= 
0, and -PK angle <= PI. 

A cautionary note is needed here, because some moves could create unexpected 
conditions. If the coordinates of a complex pole or zero are moved in such a way as 
to make the imaginary component zero, then what were two poles (or zeros) have 
become one. (If two real poles are desired at the new coordinates, you must then 
define one new real pole there.) Similarly, if a move causes the imaginary part of a 
real pole or zero to become non-zero, what was one pole or zero has become two. 
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The use of the modifier TO permits two broad possibilities. It can cause a change of 
plane, directly, for one or more poles or zeros, e.g., 

TO TS 

to z 

It also can specify a new position, with or without a change of plane, for one or 
more poles or zeros. In the latter case, the expressions used designate final location 
(not increments as they do in the BY modifier), e.g., 

TO 20, 450, TS 
TO 0.75, PI/4, Z 
TO -15, 

(In this last case, please note that when you don't specify a plane for the move 
command, the original plane of definition is used. This differs from the define 
command for poles and zeros in that omitting a plane there makes the default 
CONTINUOUS.) Each time MOVE is used, a message is displayed giving the 
number of poles or zeros actually moved. 

Examples: 

MOVE POLES 1 THROUGH 3 TOTS 
MOVE ZERO 2 BY 0.875, 0.125 
MOVE PZ TO Z 
M0VEP0LE5to0.625, PI/2, Z 

Changing from a Z-plane to any other involves an application of the matched-Z 
transform or its inverse. This transform is not one-to-one. When its inverse is used, 
the value with imaginary part closest to zero is selected from the set of possible 
inverses. This in effect selects the lowest frequency that could be aliased by the filter. 
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FUNCTIONS OF FILTER RESPONSE 



The behavior of the filter defined by the existing poles and zeros can be investigated 
with respect to its gain, phase, and deviation from gain bounds. Group delay and 
time response can also be calculated and listed or graphed. The keywords used to 
specify reference and boundary levels and those for displaying the response are listed 
in Table 5-1. 

Table 5-1 . Keywords for Gain Reference, Gain Boundaries, and 
Response Display 



AGAIN 


G 


F 




BOUNDS 








GAIN 


G 


F 




GERROR 


G 


F 




G'REF 






(initial value AT 0, i.e., dB at DC) 


GROUP 


G 


F 




IMPULSE 


G 






LBOUND 


G 




(initially -1000000 AT 1) 


MAGAIN 








MERROR 








MSQE 








PHASE 


G 


F 




STEP 


G 






UBOUND 


G 




(initially +1000000 AT 1) 



When one of the above keywords is entered as a command, its current value is 
displayed. If it is a multivalued object, e.g., GAIN, a list is displayed. Those marked 
with a G are graphable (all but BOUNDS, GREF, MAGAIN, MSQE, and 
MERROR. Those marked with an F can act as functions with frequency arguments, 
e.g., GAIN(145) will display the gain at 145 Hz due to all currently defined poles and 
zeros. 

The filter responses GAIN, AGAIN, GERROR, PHASE, and GROUP are 
functions of frequency. STEP and IMPULSE are functions of time. The response is 
calculated only for a specific range of frequencies or time. This range is determined 
by the setting of FSCALE, for frequency responses. XSIZE and TS determine the 
range for time responses (see Chapter 6). 



GAIN and GREF 

GAIN referslo a normalized-gain in decibels due to all existing poles and zeros. The 
normalization factor is the current GREF setting, namely a specified gain at a 
specified frequency. You set GREF by typing 

GREF = expression AT expression 

in which the first expression is the reference gain at the frequency given by the 
second expression. The frequency specified by the second expression need not be 
contained in the range of frequencies you set up as FSCALE. The initial GREF 
setting is AT 0, which is to say, the gain at DC is dB. 
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The GREF frequency must have nonzero absolute gain in order to compute the 
decibel GAIN. If AGAIN is zero at the reference frequency, an error message will be 
issued. 

When multiple poles exist, to see the gain for each individual pole you must remove 
them one at a time and compare the resulting filter responses with the earlier values. 
You can achieve this comparison by graphs or lists, or by defining symbols for 
storing each intermediate value. 



AGAIN and MAGAIN 

AGAIN refers to the absolute-gain, expressed as a multiplier, again due to all 
existing poles and zeros. This absolute gain can only be meaningfully determined for 
sampled poles and zeros. If nonsampled poles and zeros exist, the AGAIN will 
include a contribution for each such pole or zero, which is arbitrarily scaled. 
AGAIN is useful only when all currently-defined poles and zeros are sampled. For 
the case of continuous poles and zeros, GAIN is much more meaningful than 
AGAIN. 

The maximum absolute gain, MAGAIN, taken over the 64 or so frequencies 
contained in FSCALE, is accessible as a read-only keyword reference. This quantity 
can be displayed by name or used in expressions, and is useful in determining the 
scaling factors necessary between successive stages of the filter. 



NOTE 

MAGAIN is only the maximum AGAIN over the frequencies in FSCALE, 
and not the true maximum AGAIN. The true maximum AGAIN may occur 
between points in FSCALE or outside the FSCALE range entirely. It is 
therefore necessary to choose FSCALE appropriately to capture the 
frequency range of interest, or manipulate FSCALE to focus in on that 
range, such that seeing a smooth curve will correctly imply there are no 
hidden spikes. 



Upper and Lower Bounds 

The bounds are piecewise linear functions of frequency, with possible regions of 
"don't care," meaning any gain is acceptable therein. The region boundaries are 
specified as 

expression AT expression 

meaning a gain of the first expression at the frequency determined by the second 
expression. Up to 10 lower bounds and 10 upper bounds may be specified. 

The initial lower bound, LBOUND, is -1000000 AT 1; the initial upper bound, 
UBOUND, is 1000000 AT 1. For all practical purposes these bounds amount to a 
"don't care" condition. You can use similar settings to obtain this condition at any 
frequency. 

You set the bounds by typing one or more frequencies, separated by commas, after 
the word LBOIJND or UBOUND and an equal sign, e.g., 

LBOUND = 1 AT 5000,1 .50 AT 6500, 3.30 AT 13000 
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This means the minimum acceptable gain at 5000 Hz is 1 decibel, rising to 1.50 
decibels at 6500 Hz, rising to 3.30 decibels at 13000 Hz. The frequency scale is 
logarithmic. The gain between these frequencies is a straight line, viewed on this log 
scale, connecting the specified gains at each point. The frequencies must be greater 
than and given in increasing order, e.g., specifying 

UB0 = 1 AT 
or 

LB0 = 1 AT 5000, 5 AT 4000 

is illegal. 

If the bounds are separated by two commas instead of one, this specifies a don't care 
region, in which any gain is acceptable, between the two given frequencies. (That is, 
the deviation of the gain is zero regardless of how high or low the gain is.) Similarly, 
the regions below the first frequency specified and above the last frequency are don't 
cares. If LBOUND and UBOUND are both specified, LBOUND must be less than 
UBOUND (or you get an error message). Bounds frequencies need not lie within the 
range of frequencies determined by FSCALE. 

NOTE 

"Don't care' ' conditions permit the CODE command (discussed in Chapter 7) 
complete latitude in frequency responses and pole/zero repositioning. 



Other Filter Responses and Keywords: 

GERROR, MSQE, MERROR, PHASE, STEP, IMPULSE 

GERROR refers to the deviation of the gain response from the bounds you set. A 
positive GERROR indicates a gain exceeding the upper bound set for that 
frequency. A negative value of GERROR means a gain less than the lower bound for 
that frequency. 

The mean square error, MSQE, and the maximum absolute error, MERROR, are 
accessible as keyword references. The former is the mean square deviation from the 
bounds taken over the frequencies in FSCALE. The latter is the maximum absolute 
deviation from the bounds, taken over the same frequencies. (In order to see the 
exact frequency at which this maximum occurred, you must graph the error as 
described in Chapter 6.) 

As with MAGAIN, note that MERROR is only the maximum error over the 
frequencies in FSCALE, and not the true maximum error. The true maximum error 
may occur between points in FSCALE or outside the FSCALE range entirely. It is 
therefore necessary to choose FSCALE appropriately to capture the frequency range 
of interest, or manipulate FSCALE to focus in on that range, such that seeing a 
smooth curve will correctly imply there are no hidden spikes. 

Thus MSQE and MERROR are functions of the existing poles and zeros, the 
bounds, and FSCALE. MAGAIN is a function of the existing poles and zeros and 
FSCALE. 

PHASE refers to the phase delay response of the filter, in units of radians. GROUP 
refers to the group delay of the filter in seconds, i.e., the negative of the derivative of 
the phase with respect to the frequency. (See Appendices H and I for formulas, 
graphs, and a brief review of these functions.) 
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STEP refers to the filter output in response to a unit up-step at time zero. 

IMPULSE refers to the filter output in response to a unit up-impulse at time zero. 

Since continuous convolutions are implemented by approximating them with 
discrete convolutions, the accuracy of these time responses is dependent on the 
setting of TS and the location of continuous poles and zeros. 

In particular, those defined at high frequencies (relative to TS) will contribute 
noticeably to this inaccuracy. If there are any continuous poles or zeros, then the 
magnitude of the impulse functions is defined as 1/TS. Otherwise, the impulse is 1. 
All time responses for continuous poles and zeros are normalized so that the final 
output level to a step input matches the gain at DC. However, for sampled poles and 
zeros, these responses are not normalized. 

Except for STEP and IMPULSE, these filter responses may also be used as func- 
tions, computing the indicated response at a frequency specified as an expression in- 
side parentheses following the filter response keyword. The value of this expression 
need not lie within the range of the FSCALE (or the time scale determined by TS and 
XSIZE). These functions can be displayed or used in expressions, interactively or in 
compound commands (Chapter 9.) 



Response Keyword 






Computation Uses 






GREF 


FSCALE 


State of HOLD BOUNDS 


Time Scale 


GAIN 


X 


X 


X 




AGAIN 




X 


X 




GERROR 


X 


X 


X X 




PHASE 




X 


X 




GROUP 




X 


X 




STEP 








X 


IMPULSE 








X 



HOLD 

In typical 2920 applications, after a signal is sampled and filtered, it is usually kept 
in a sample-and-hold buffer until digital-to-analog conversion and output takes 
place. There is an implicit distortion due to this sampling, holding, and converting 
which amounts to a high-frequency droop cut off at 1/TS. GAIN attenuates by 
about 4 dB at half the sample rate. Below half the sample rate this distortion 
approaches zero. The attenuation increases above half the sample rate. 

The correction for this distortion is to multiply AGAIN by |sin(x)/x|, where x is half 
the digital frequency, i.e., 

|SIN(X)/X| where X=TS*FREQ*PI 

The effect of this on GAIN is to add 20*log|sin(x)/x| (to the base 10). PHASE is 
corrected by adding X. GROUP is corrected by subtracting TS/2. No other filter 
responses are affected. 

The command HOLD OFF removes these corrective contributions. 

HOLD is initially OFF, and in this state the SPAC20 Compiler accurately describes 
analog filters. Most 2920 filter designers should have HOLD ON when examining 
the responses of the filter as a whole, and HOLD OFF when examining AGAIN to 
determine inter-stage signal scaling (see Appendix J). 
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SCALES 

All of the graphs and most of the calculations performed by the SPAC20 Compiler 
depend on a few key independent variables that you set early in any interactive 
session. The frequency and time scales are two of these. The former is FSCALE. 
The time scale depends on the values of TS and XSIZE, as explained below. 
YSCALE controls the values on the vertical scale of each graph. XSIZE and YSIZE 
specify the size of the CRT screen. 



Frequency and Time Scales 

The frequency scale (FSCALE) serves to format the graphic display and to restrict 
the domain of interest, i.e., the frequency range for which filter responses are 
computed and graphed. 

The frequency response of the filter is only calculated for the approximately 64 
frequencies in FSCALE, as are GERROR, MERROR, MAGAIN, and MSQE. The 
automatic initial FSCALE setting is 

FSCALE = 10,10000 

meaning 10 to 10,000 Hz. New settings are in the form 
FSCALE = expression, expression, ... 

permitting N expressions, (up to 10) of increasing positive values, separated by 
commas. 

The effect of these is to divide the graphics area of the screen (determined by XSIZE 
and YSIZE) as evenly as possible into N-l partitions, with the N equally spaced 
points given the indicated expression values. Then, within each partition, the 
frequency scale (in Hertz) is filled in logarithmically. This enables you to achieve a 
nearly linear scale or to emphasize certain frequency regions of interest. Note, 
however, that zero is not allowed on FSCALE, and the frequencies must be in 
ascending order. 

Examples: 

FSCALE = 500,5000 

FSCALE =500,1500,2500,5000 

FSCALE = 500, 1000, 1500, 2000, 2500, 3000, 3500, 4000, 4500, 5000 

In the case of the time scale, the domain you create via TS and XSIZE impacts the 
amount of computation time needed to calculate the STEP or IMPULSE response. 
Time responses are computed for a number of sample intervals. The initial default 
value is 69. The number depends on XSIZE, e.g., if XSIZE>= 79, then 69 sample 
intervals are used, from to 68*TS. 
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The time scale is in units of seconds, and its automatic setting is from to the 
product of TS and the plot size, i.e., XSIZE-10 up to a maximum of 69. Thus if the 
screen width XSIZE has been set to 60, and the TS sample interval is set at 1/10000, 
then the time scale will run from to (60-10)/10000, or from to .005 seconds. TS 
must be nonzero, i.e., you must set it to a sampling rate meaningful to your 
problem. 



XSIZE, YSIZE, and YSCALE 

You set the system variables XSIZE and YSIZE to determine the size of the graphics 
area. Since three horizontal rows are dedicated to labeling the graph's X (horizontal) 
axis, YSIZE-3 rows are left for graphics (a minimum of 1 up to a maximum of 22). 
Ten columns are needed for labeling the Y (vertical) axis, leaving XSIZE-10 columns 
for graphics (from 2 up to 69 maximum). 



XSIZE also determines the number of frequencies for which the gain of the filter is 
calculated, and thus also affects the calculation of GERROR, MERROR, 
MAGAIN, and MSQE. 



The last remaining scale you set is named YSCALE, referring to the vertical scale 
(dependent variables). It serves to format the graphic displays obtained with the 
GRAPH or OGRAPH commands explained later in this chapter. If you specify 
YSCALE = AUTO, this means each curve plotted by the SPAC20 Compiler should 
entirely fill the screen, using a vertical scale selected by the Compiler to achieve this 
purpose. 



If the numbers necessary to represent the range in YSCALE require more than 10 
columns, the scale will appear as percentages instead of the actual YSCALE 
numbers. If this appears on your graphs, you can display the actual range used by 
typing YSCALE as a command, i.e., followed by a carriage-return. If the original 
specification was AUTO, then this will display the word AUTO followed by the 
actual numbers used. This situation can occur also if you specify more than 10 digits 
in a range for YSCALE, or if the range is so narrow as to require more than 10 
columns, e.g., '10 TO 10.000001'. 



If you specify two expressions, as in setting FSCALE, this means the bottom of the 
display should correspond to the value of the first expression, and the top of the 
display should correspond to the value of the second expression. These numbers 
need not be in increasing order. Thus if you specify 



YSCALE = 0,-40 
the GAIN graph will look upside down, like an attenuation graph. 

Values exceeding the range specified by YSCALE are explicitly indicated on the 
graph by an asterisk, denoting saturation. The vertical resolution is actually the 
vertical range divided by 3*(YSIZE-3), since three different characters are used to 
represent three different levels on each console line. 
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When used with a valid object, e.g., GRAPH GAIN, the commands GRAPH and 
OGRAPH fill a buffer area with characters whose positions represent the values of 
the object. The proper positions are selected within the graphics area you have 
defined using XSIZE and YSIZE (or the default area, which is the full screen). 

The characters used for the latest curve are the period, dash, and apostrophe (. - '), 
so that effective vertical resolution is three times that of a single letter. When 
OGRAPH is used, the plot also contains the previous curve graphed, but with the 
characters all replaced with the character "+", to distinguish the older curve. The 
scale appropriate to the newer curve is displayed, but the physical positions of the 
old graph on the screen remain unchanged. 

If GRAPH is used alone, with no object, the latest graph displayed is redisplayed 
regardless of intervening changes in any state variables. This can be used to recover a 
display which has scrolled off the console screen. 

Hard-copies of the graphics output and all other console activity can be obtained by 
defining a list file or device using the LIST command (see Chapter 8). No special 
graphics capabilities are required of the device. 
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CHAPTER 7 

CODE GENERATION FOR THE 

INTEL 2920 PROCESSOR 



The Code Command and Constraints 

After manipulating the pole and zero positions to get the frequency and time 
responses of the filter to match the characteristics you want, you may create AS2920 
assembly language code for each pole or zero (or conjugate pair) with one CODE 
command per object. 

These commands perform compilation, generating as many AS2920 instructions as 
are needed to correspond either to a pole or zero or to an equation. (Such equations 
are useful in propagating and scaling the signal passed between filter stages.) The 
code generated by the most recent CODE command is maintained in a code buffer 
which can be displayed (by simply entering CODE), or sent to a file (Chapter 8). 

The code will automatically contain comments to identify the location and label of 
the pole or zero, or to specify the value of the multiplier in the case of an equation. 
Comments usually show the current contents of the destination operand in each 
instruction, in terms of the constant and variable names supplied in the CODE 
command. The AS2920 Assembler ignores these comments. 

In general, the code generated will not implement the requested object exactly. 
Instead, the code is generated with respect to the constraints explained in this 
chapter: INST, ERROR, MSQE, MERROR, and PERROR. The keyword INST 
shows the number of instructions compiled. For an equation, the accuracy of the 
resultant compilation is reflected in the value of the keyword ERROR. 

For a pole or zero, the accuracy of the code is reflected in the values of MSQE and 
MERROR, if referenced immediately thereafter. If there are intervening commands, 
MSQE and MERROR may be rewritten to reflect them. The imprecision of compila- 
tion for a pole or zero, i.e., the object's "movement," is explained below under 
PERROR. The "error", therefore, is also reflected in how far the actual object (as 
compiled) differs from its original position. 

If the constraint is too severe and cannot be achieved in the number of 2920 instruc- 
tions requested, then the Compiler selects that set of generated code which 
minimizes the constraint you gave, within that number of instructions. If the code 
object is a multiplication when this happens, ERROR is given the minimum error 
(signed) achievable in the number of instructions given by the value of INST. 
Interrupting the Compiler with an ESCape key while it is generating code causes the 
best yet code to be entered into the CODE buffer, and then halting generation. 

The elements of the chart below are discussed in subsequent paragraphs. 
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Coding a Single Pole or Zero 

As the chart above indicates, there are four constraints for use on coding poles or 
zeros. Each is explained below. The command begins with the word CODE, 
followed by the desired object and its label, leading to one of the four constraints, as 
follows: 

MSQE < expressi on 
or 

MERROR <expression 
or 

PERROR<expressio n_1 , express io n_2 

Of these three, at most one may be chosen for any given CODE command. If none 
appears, the default PERROR<0,0 is used, resulting in minimum movement from 
the original coordinates of the pole or zero (see below). If one of these three 
constraints does appear, it may optionally be followed by a comma and the program 
size constraint, as follows, 

, INST < expressi on 

which restricts the number of instructions generated to fewer than the value of the 
expression given. The INST phrase may appear alone, i.e., without a comma and 
without any other constraint. If it is not supplied, a default limit of 20 is 
automatically used. 

Using the constraint 

MSQE <expression 

means that the gain of the coded filter is to deviate from the bounds by less than the 
value of the expression given. Further, this must be achieved in fewer than 20 
instructions (or the number you supply in the INST phrase). 

Examples: 

CODE POLE 1 MSQE <0.2 

CODE ZER09MSQE <0.02, INST<6 

Using the constraint 

MERROR < expression 

means that the maximum absolute error of the coded filter's gain is to be kept below 
the value of the expression given, also within the instruction limit supplied. 
("Error" means deviation from the gain bounds you supplied in earlier commands.) 

Examples: 

CODE POLE 1 MERROR <0. 2 

CODE ZER09MERR0R <0.02 f INSK17 

Using the constraint 

PERROR<expressio n_1 , expressio n_2 
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means that there is a limit on the movement (explained below) of the coded pole or 
zero from the original position of the defined pole or zero. That is, the difference of 

their first coordinates must be less than expression 1, and the difference of their 

second coordinates must be less than expression 2. Once again, this must be 

achieved within the INST constraint, i.e., in fewer instructions than the limit 
supplied. 

This constraint requires some further explanation. PERROR is needed because the 
assembly language program generated by the CODE command implements a filter 
stage corresponding to a pole or zero at a slightly different location than the 
specified original pole or zero. After the compilation has been performed, the pole 
or zero is moved to the location matching the code generated. (However, this move 
will never change a complex conjugate pole [or zero] pair to a single real pole [or 
zero], nor a real into a complex conjugate pair.) 

PERROR constrains the amount of that movement, in each coordinate, in the home 
plane (TS or Z) of the pole or zero. For poles or zeros defined in TS, these 
coordinate increments will be <real,imaginary> in Hertz. For those in Z, the 
increments will be <radius, angle (in radians)>. 

MSQE and MERROR will always contain values which reflect the actual position of 
currently existing poles and zeros, i.e., including this implicit move. PERROR 
cannot be displayed. The original position of the coded pole or zero is lost. Thus you 
may wish to save it using a PUT or APPEND command (described in Chapter 8) or 
by saving its coordinates in the symbol table, e.g., 

.0RIG_P0LE_3_REAL = REAL (POLE 3) 
.0RIG_P0LE_3_IMA6 = IMAG (P0LE3) 

Examples: 

CODE POLE 1 PERROR <4.2, 2 

CODE ZERO 9 PERROR < 4.02, 0.06, INST<9 

In any case if the MSQE, MERROR, or PERROR constraint cannot be met within 
the INST constraint, the Compiler selects that set of code which minimizes the 
specified constraint in the given number of instructions. In the case of PERROR, 
what is minimized is the variance from your specified constraints on coordinate 
changes, as follows: 

Suppose, for POLE 1 at XORIG, YORIG, you give constraints XCON and 
YCON, as in 

C0DEP0LE1 PERR0R<XC0N, YCON 

then call the actual pole position XTRY, YTRY (for each set of code attempted 
by the Compiler). 

This represents a movement of XMOV, YMOV, i.e., 

I XTRY - XORIG | = XMOV 
I YTRY - YORIG I = YMOV 

Using these definitions, then, the Compiler selects that set of code which 
minimizes 

(XM0V-XC0N)**2+ (YM0V-YC0N)**2 
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Minima and Error Constraints 

None of the minimizations above are necessarily true minima. True minima would 
require trying every possible code sequence, because the constraints MSQE and 
MERROR, which depend on the bounds you supply, can in fact behave quite non- 
linearly. The SPAC20 Compiler's algorithms for selecting the approximate 
minimum work best when the error bounds are "reasonable". Therefore, it is 
required that before coding is begun, the MSQE or MERROR for the gain curve 
must already meet your intended constraint. Thus if the code generated corresponds 
exactly to the specified pole or zero, the MSQE or MERROR constraint will be 
satisfied. 

Coding Equations 

The second form of the CODE command generates AS2920 code for calculations of 
the form YY=C*XX or YY=C*YY or YY=C*XX+YY, where C is a constant and 
XX, YY are variable names. The INST constraint can be used as above. Code is 
produced which minimizes the error in the multiplier (C) as much as possible in the 
number of instructions specified (or in 20, the default). 

The other constraint allowed (besides INST) is 

ERROR < expression 

(which may be followed by a comma and an INST constraint). This specifies that the 
error in approximating C must be less than the value of the given expression, within 
the number of instructions desired. After the coding is completed, the value of 
ERROR shows the absolute value of error in the multiplier. The variable names used 
to request this coding will appear in the generated code. 

In the absence of an explicit ERROR constraint, the default is 
ERROR<(multiplier/2**16), i.e., create the least ERROR possible (out to 16 binary 
places) within the INST constraint. If the given error constraint cannot be met, 
ERROR is minimized. 

Examples: 

CODE WAR = 1 .58 *XVAR 

CODEZVAR = 0.692475*AVAR INST < 6 

CODE XVAR = 2.3975* WAR ERROR < 0.0025 

CODE WAR = 0.11825 * XVAR + WAR ERROR<0. 00125, INST<5 

Note 

YY = YY + C*XX is not acceptable. The equation must be requested in the 
form YY = C*XX + YY 

In general, it takes no more than one 2920 instruction per 2 significant bits in the 
specified constant. Thus 24-bit accuracy could be theoretically obtained in at most 
12 instructions. However, the SPAC20 algorithms are not substantially effective 
beyond 16 bits, so that in most cases an INST constraint of less than 8 is sufficient. 
Greater accuracies can be obtained through techniques explained in Appendices H 
and J. Code generated for equations of the form YY=C*XX is the most efficient, 
achieving approximately 3 significant bits in the constant per instruction generated. 

The code generated for a multiplication by a constant C will not overflow as long as 
the multiplicand is less than 1/C in absolute value. If the multiplicand is greater 
than 1/C in absolute value, an overflow will occur on the last instruction (and 
possibly earlier), yielding a result of ± 1 . 
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CHAPTER 8 
FILE HANDLING 



This chapter covers the commands EXIT, LIST, WRITE, DISPLAY, APPEND, 
PUT, and INCLUDE. Certain features of the operating system on INTELLEC 
computers are used by these commands. 
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Interface with ISIS-II 

The Intel Systems Implementation Supervisor (ISIS-II) is the diskette operating 
system for the Intellec Microcomputer Development System. The Signal Processing 
Applications Compiler runs under ISIS-II control, and can call upon ISIS-II for file 
management functions. To execute the SPAC20 Compiler, you enter the characters 
SPAC20 (possibly preceded by a drivename, e.g., :F1:SPAC20) after an ISIS-II 
prompt character (hyphen "-" or angle bracket ">"). 

The Compiler signs on with a message 

ISIS-II 2920 SIGNAL PROCESSING APPLICATIONS COMPILER, V1.0 - MATH BOARD VERSION 
* 

indicating by the asterisk prompt that it is ready to receive commands. 
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With the exception of EXIT and WRITE, the commands in this chapter are used to 
reference files or devices via ISIS-II pathnames. For diskette files, the format of 
pathname is as follows (a pathname may not contain blanks): 

: dri ve : f i I e name 

e.g. , :F1 :MYFILE, 
: F : Y F I L E , 
FILE79 

The entry :drive: stands for one of the references to INTELLEC system diskette 
drives. FO is assumed when drive is omitted. See the ISIS-II User's Guide for further 
detailed data. 

The entry filename must follow the colon after drive without any intervening spaces. 
A filename has the following components: 

identifierC. extension] 

The above identifier is a name you assign, and is one to six alphanumeric characters. 
The extension is an optional part of the filename, consisting of one to three 
alphanumeric characters preceded by a single period. The extension must be used if 
it is present in the directory listing of the file on the diskette. 

If used, the extension follows the identifier without any spaces. Some extensions 
(e.g., .BAK, .LST) are assigned by system processors; others can be assigned as you 
like. An extension provides a second level of file identification; it can be used to 
distinguish different versions of the same program, or to give supplemental infor- 
mation about the file (e.g., author, date, version). 

For devices other than diskette files, the format of pathname is as follows: 

: d e v i c e : 

The following devices are commonly accessed in SPAC20 Compiler commands: 

:DEVICE: OUTPUT DEVICE 



LP: 


Line Printer 


HP: 


High-speed tape punch 


TO: 


Teletypewriter printer 


CO: 


Console display 


CI: 


Console Input 


HR: 


Paper tape reader 



For more information on ISIS-II filenames and device codes, refer to the ISIS-II 
User's Guide. 



EXIT 

The EXIT command keyword returns control from the SPAC20 Compiler to ISIS- 
II. It is as simple as it looks. Any files opened during the session are closed. After the 
line terminator has been entered following the command EXIT, access is no longer 
possible to any prior commands, parameters, macros, calculations, and graphs or 
lists which have not been saved into diskette files or onto hard-copy listings. 
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LIST 

All output is normally sent to the console device (:CO:). The LIST command saves a 
duplicate record of the console input and output during a SPAC20 Compiler 
session, including high-volume data such as graphs or listings, on a hard-copy device 
or on a diskette file. 

Only one LIST device or file other than the console can be specified (active) at a 
given time. Devices that can be specified, if present, are a line printer (:LP:), high- 
speedpaper tape punch (:HP:) or a teletypewriter printer (:TO:). 

Instead of a hard-copy device, a diskette file can be specified. If so specified, the file 
is opened when the LIST command is invoked. If a file of that name already exists, 
its directory entry is deleted and the name will thereafter refer to the list file being 
generated. 

When LIST is in effect (with a device or file other than :CO:), all commands input 
(including comments) and all output from the SPAC20 Compiler (including system 
prompts, commands, graphs, and error messages) are sent both to the named device 
or file and to the console display. 

To restore output to the console only (no other device), use the command LIST 
:CO:. 

Examples: 

LIST :LP: 
LIST :C0: 

LIST :F1 :DESI6N.930 
LIST :T0: 
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The command WRITE puts out a single line of output to the LIST file and the 
console. It evaluates any expression you supply prior to output. In interactive 
sessions you would rarely use it, since the EVALUATE command provides the same 
function without the file output effect. WRITE is normally used within compound 
commands to provide periodic reporting on an automatic iterative process you have 
designed to test or generate special capabilities (see Chapters 9 through 11). 



Examples: 



WRITE 'Process now beginning step', .STEPNO, 'of section', .SECTNO 
WRITE 'Stage number 3 of filter number 1 , device MDM' 
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Display Command 

The DISPLAY command copies the contents of the named file to the console. It 
enables you to examine the results of an earlier PUT or APPEND command without 
invoking execution of the results. The INCLUDE command, explained later in this 
chapter, does invoke execution. 

Examples: 

DISPLAY :F3:PARAM.FIL 
DISPLAY CODFILPOL 
DIS MYMACR.OS1 
DIS PUT30K 

Here, as in general, ESCape can be used to abort the command, terminating the 
display and returning you to the command level (asterisk prompt) of the Compiler. 

One scenario for the use of this command is this: after saving all poles and zeros 
(using a put or append command as discussed below) and altering some of them, 
possibly via CODE commands, the display command permits a review of the earlier 
positions without disturbing the current conditions. The display can be interrupted 
with control-S (holding down the control key while pressing S), and restarted using 
control-Q. However, it is not possible to display a file that is currently open, e.g., a 
LIST file in use recording this session, or the current MAC.TMP (see Chapter 9). 



APPEND Command 

APPEND adds the specified (or default) objects described below to the end of the 
named file, if it exists. If it does not, the command creates it. Most file objects (other 
than CODE, strings, or expressions) cause SPAC20 commands to be output to the 
file. These commands will recreate the stated objects when invoked (executed) by a 
subsequent INCLUDE command. PZ, BOUNDS, SYMBOLS, and MACROS will 
cause the restoration, respectively, of all poles and zeros, bounds, user symbols, and 
macros. 



If no file object is supplied, commands are generated to permit restoring as much as 
possible of the state of this session. In particular, if you re-invoke the Compiler and 
include the file that you just PUT, your state will be restored exactly. This means, in 
addition to PZ, BOUNDS, SYMBOLS, and MACROS, commands to restore TS, 
XSIZE, YSIZE, GREF, HOLD, FSCALE, and YSCALE. 



The file object CODE refers to the current contents of the code buffer, i.e., the 
results of the last CODE command. By APPENDing the results of successive such 
commands, the user can build up a file containing the assembly language code 
implementing the successive stages of a filter. 



A list of expressions and strings can be used as a file object, resulting in the ASCII 
text of the strings and the decimal values of the evaluated expressions to be output 
on one line to the file. This can be used to insert comments in the growing assembly 
language file, or to insert assembly language code to perform scaling and propaga- 
tion between filter stages. 
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Examples: 



APPEND :F2:PZALL PZ 

APPEND P0LE9.C0D CODE 

APPEND NEW. MAC MACROS 

APPEND :F1 :PARAMS. ALL 

APPEND FILTER. CUR PZ, SYM 

APPLATEST.COD CODE, ' ;aboveisforstage3,filter2, 11/15/79' 
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PUT Command 

PUT operates identically to APPEND with a single difference: if the file named in 
the command already exists, PUT overwrites it with the supplied (or default) file 
objects. (A message is sent to the console if such an overwrite occurs.) In general, 
APPEND should be used in all cases save where you are absolutely sure you will not 
regret destroying any possible earlier file of the same name. When in doubt, you can 
use the DISPLAY command to check if the file exists, and if so, what's in it. 



Examples: 

PUT :F2:PZALL PZ 

PUT P0LE9.C0D CODE 

PUT NEW. MAC MACROS 

PUT :F1 :PARAMS.ALL 

PUT :F1:0LDFIL ' ' ; this overwrites and empt ies out OLDFIL 

PUT FILT07.C0D CODE ' ; above ',INST,' instructions implement 

stage ' , .STAGE, ' , f i Iter 7' 
; (assuming .STAGE was earlier defined to label the stage 

current ly coded) 
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INCLUDE Command 

This command enables you to restore some or all of the key parameters/states/tools 
from a prior interactive session for use during this one. When you issue the 
command 

INCLUDE pathname 

(where pathname is usually a diskette filename, e.g., CODFIL.922 or 
:F1:MACR0S.921) the commands stored in that file are executed as if you had 
typed them directly from the console. Thus, if in your earlier session you had issued 
the command 

APPEND NEWFIL. 921 PZ 

then when you INCLUDE NEWFIL. 921 in this session, all poles and zeros defined 
at the time of the earlier command will be reestablished by DEFINE POLE 
commands for this session. This is true for any of the parameter-related file-objects 
for APPEND or PUT (i.e., INCLUDE should not be used for files of CODE, 
strings, or expressions). If the earlier PUT or APPEND had no specified file object, 
then all relevant parameters would have been saved. Your current INCLUDE 
command would then cause the restoration of all poles, zeros, bounds, scales, 
symbols, macros, sample rate, reference gain, hold state, and screen-size parameters 
to their earlier values, effectively restarting that session. 

The INCLUDE command is particularly useful when building a library of macros 
(Chapter 9). Macros can be created but not edited interactively. If your macros 
contain more than two or three commands, you may wish to create the macros using 
an editor (e.g., CREDIT) in the form of an INCLUDE-able file. 

The SPAC20 Signal Processing Applications Compiler can also be run under 
SUBMIT (see ISIS manual for detailed instructions). However, macros to be used 
under SUBMIT should be INCLUDEd rather than defined in-line in the submit-file. 
This preserves the distinction between the formal parameters of the submit 
command and the formal parameters for macro definition. 
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CHAPTER 9 

ADVANCED (COMPOUND) 

COMMAND SYNTAX 



This chapter discusses macros and the other compound commands: IF, REPEAT, 
and COUNT. Compound commands consist of sequences of simple commands to 
be executed in order as described below. 

When commands are being input as part of compound commands, the normal 
asterisk prompt character is preceded by a period, to indicate the compound 
construction. If the compound command is itself embedded within another 
compound command, then the commands in its subordinate command block will 
have two periods before the prompt, and so on for deeper levels of nested compound 
commands. 

Some typing or syntax errors cause only the current line to be rejected. This is 
indicated by the Compiler repeating the same sequence of prompt-characters that 
began the last line, e.g., "..*". However, more serious errors cause rejection of the 
entire compound command, forcing you to retype the command from the very 
beginning. This is indicated by a single asterisk (*). 



Macros 

A macro is a named block of commands, executed in sequence (or containing 
branches, if you so specify) when the macro name is typed as a command (invoked). 
The block of commands is also called the macro body. 

The sequence is stored as you define it. This saves you repetitive entry of every 
command in the sequence, and also permits you to capture conditional logic 
(instruction branches or loops) only once, for potentially frequent use in future 
sessions. The macros you define are saved on a temporary file on diskette, but this 
file is not saved when you exit. If you use the commands 

PUT f i Lename MACROS 

or 

APPEND f i lename MACROS 

prior to exiting, then the macros may be INCLUDEd for use during any future 
session. 

The macro commands described in this chapter allow you to perform the following 
functions: 

• Define a macro, specifying the macro name, the command block, and any 
formal parameters (points in the macro definition where text can be replaced by 
actual parameters when the macro is invoked) 

• Invoke (call) a macro by name, giving actual parameters to substitute for chosen 
formals (if any), beginning the execution of the defined command block 

• Display the text of any macro as it was defined 

• Display the names of all macros currently defined 

• Remove one or more macros from those currently defined 
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Each macro used in any design/test session must be defined during that session. 
Once defined, it may be invoked as often as desired, even within other macros. 

The definition can occur either by typing it or by bringing it in from a file via the 
INCLUDE command (see Chapter 8). The macro name must be an identifier as 
described in Chapter 2, and must not duplicate any other macro name used in this 
session. (Thus you may not redefine a macro name, nor include it from a file, unless 
it is first removed from the macro table (directory) as described later in this chapter.) 
It may, however, duplicate symbol or keyword identifiers. 

The DEFINE MACRO command causes the macro name (and the block of 
commands you supply) to be stored in a table of macro definitions in a temporary 
ISIS-II file named MAC.TMP (on the same disk drive containing SPAC20). Upon 
exit, they will not be retained. If you create new macros during this session, in 
addition to any you may have INCLUDEd, then to save them for future use you 
must save them as described above. Since macros cannot be edited within SPAC20, 
you may wish to use the Editor to create INCLUDE files for long or complex 
macros, making it easier to correct errors in typing or command constructs. 

A macro definition (or removal) may not appear within any other command. This 
means you may not define a macro within another macro definition sequence, nor 
within any other compound command. Any other command may appear in any 
compound command. 

When you attempt to invoke a macro, the macro name you supply must be already 
defined. 

Here is a simple macro definition: 

DEFINE MACRO GRAPHER 
REPEAT 

MOVE POLE 1 BY 0,5 
OGRAPH GAIN 
END 
EM 
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To invoke this macro and cause its command block to begin executing, you enter the 
macro name preceded by a colon(:), as follows: 

:GRAPHER 

This will continue to move the pole by the indicated increment, and overgraph the 
new gain, until you hit ESCape. 

A macro definition can include commands that define user symbols and other 
identifiers, such as poles or zeros, sample rates, etc. Macros that include such defini- 
tions can be used to set certain initial conditions for many of your interactive 
sessions. INCLUDE files can also be used for this. 

A macro definition can include calls to other macros, but not to itself. If you 
inadvertently create one that tries to call itself, it will expand indefinitely when it is 
first invoked, without ever executing any later commands. (Press ESCape to 
terminate such an infinite expansion.) 

Macro calls can be nested, i.e., one macro calls another, which in turn calls another, 
and so on. The level of nesting is limited only by the memory space required to 
contain the macro expansions and to stack the macro calls. 

When a macro is invoked, the following operations occur: 

• The text of each actual parameter in the call is substituted for the corresponding 
formal parameter in the definition 

• The expanded command block is executed if all commands are valid as 
expanded 

• The macro exits. Control returns to the console (asterisk prompt), or to the next 
command in sequence if the macro was invoked inside a compound command. 

It is usually more efficacious to define several small macros rather than one large 
one incorporating all their features. They are eaiser to type in and more likely to fit 
in memory. The Chebyshev macro shown in Chapter 10 is a good example of a 
maximum-sized macro. 



Formal and Actual Parameters 

A formal parameter marks a place in a macro definition, where text will be replaced 
when the macro is invoked. A formal parameter can represent part of a token or a 
field of one or more tokens. When you invoke the macro, you supply the actual text 
which is to replace the formal parameter as the macro is expanded. A macro defini- 
tion can contain up to ten formal parameters, each having the form: 

%N 

where N is a decimal digit, through 9. For example, if you modify the macro 
GRAPHER above to read 

DEFINE MACRO GRAPHER2222 
REPEAT 

MOVE POLE 1 by %0, %1 
OGRAPH GAIN 
END 
EM 
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then each call to GRAPHER2222 can specify different increments for the MOVE, 
e.g., 

:GRAPHER2222 0,5 ;(thenESCapetostopexecution) 

:GRAPHER2222 0.5,12 ; (ESC to stop) 

and so forth. 

Formal parameters can appear in the body of the macro definition in any order, and 
each one can appear any number of times. This means that %3 can be used in a 
command before %1 is used, and either can appear often or not at all. The number 
implies the order in which the actual parameters will appear in the call, i.e., %0 
means use the first actual parameter supplied, 97o 1 means use the second, %4 means 
use the fifth, etc. 

A string can be supplied as an actual parameter to a macro. In fact, if the parameter 
contains a quote mark, a carriage-return, or a comma, the parameter m ust be sent as 
a string, or errors will occur. (Of course, this means any embedded quote marks 
must be doubled to avoid looking like the end of the string.) 

The quote marks surrounding the string in the macro call (invocation) are stripped 
off before the macro uses the string. If the command that uses this string, within the 
macro, requires the string to have quote marks around it, then either the macro 
definition must supply them or the string used in the call must have an extra set of 
quotes surrounding it. This will be shown in examples below. 

If an actual parameter is omitted in some call, the comma which normally would 
follow that parameter must be typed anyway to retain the necessary positional order 
of supplied parameters. This naturally does not apply to the actual parameter 
corresponding to the last formal, which would have no comma after it. In fact, if the 
omitted parameters are all at the end of the list, no extra commas are required. 

Omitted parameters result in the corresponding %N being replaced by the null 
string. If you supply, in the call, more actual parameters than there are defined 
formals in the definition, the extra actuals are ignored. 

As an example, suppose you had defined this macro: 

DEFMACBATCH 

%0 

%1 

%2 

%3 
EM 

This would permit you to string out, on one line, up to four commands. You could 
type, for example, 

:BATCH GRAPH GAIN, OGRAPH PHASE, GRAPH IMPULSE, OGRAPHSTEP 

If you supplied only 3 or 2 commands, the last formals would expand to the null 
character and this macro will exit normally. 

However, if there are any actual parameters being supplied after an omitted actual, 
the extra comma mentioned above must be supplied. The examples below will 
illustrate this. 
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If a formal parameter does not appear in the macro's command block, then 
anything supplied in that position in the call will be ignored. For example, if your 
command block never referred to %2, then the third parameter in the call would 
always be ignored. Conversely, if the block does refer to %2 but the call does not 
supply a third parameter, the null (empty) string will be supplied. The command 
containing that reference to %2 must be a valid command even in the absence of an 
actual parameter, or the macro will abort when that command is encountered during 
expansion of the macro. 

One example of such a possibility is the APPEND command: 

DEF MAC SAVER 

APPEND %0 %1 %2 

APPEND %3 %4 %5 
EM 

Note that if you supply only °IoO and %3, the filenames, the APPEND commands 
are still valid because no object is required — the default will be used. 

Using the macro SAVER, you can now type a single line to establish (or add to) one 
or two files, old or new, using the APPEND command with any combination of its 
possible file-objects: PZ, BOUNDS, SYMBOLS, MACROS, CODE, strings, 
and/or expressions. One advantage to this hypothetical macro is being able to 
specify two separate files. 

For example, one call to SAVER could add new macros to the accumulated set of 
macros, and in the same invocation put out the latest CODE to the growing file of 
coded filter-stages: 

: SAVER MA C. NOW, MACROS, ,C0DE. NOW, CODE 

Or, with parameter %4 being CODE, parameter %5 could create a comment line 
identifying the filter stage or other data pertinent to this code block: 

:SAVER MAC, MACROS, , COD, 'CODE,' , ' ' ' STAGE 4 of F I LTER 2 • ' ' 
:SAVER MAC, MACROS,, COD, CODE,','" STAGE 4ofFILTER2 ,,, 

The outer apostrophes around 'CODE,' are required due to the embedded comma, 
which in turn is needed to separate the objects of the second APPEND. (Note also 
that in order to supply the APPEND with a string in quotes, it is necessary in the 
macro-call to surround the quoted string with another pair of quotes. An actual 
macro parameter given with quotes has the outermost pair, i.e., the first quote and 
the last, stripped off during the process of being substituted for the formal 
parameter in the macro body. Also, quotes appearing within a string must be 
doubled.) 

Possibly you might wish to have one file for poles and zeros and bounds 
(PZ, BOUNDS) and one for SYMBOLS, MACROS: 

:SAVER PZBOUN, 'PZ,', BOUND, MACSYM, MACROS, ', SYMBOLS' 
12 3 4 5 

Here each actual parameter is flagged with the formal it replaces. Again, the 
embedded commas are needed for valid APPEND commands, and so are put inside 
quotes, to be sent as part of a string. The other commas simply separate the actual- 
parameters in the macro-call. 



9-5 



Advanced (Compound) Command Syntax SPAC20 Compiler 

More Examples: 

:SAVER PZ.9, PZ,, COD. 9, ,,, ;thiswasforstage4offilter5. ,,, 

The above macro call appends to PZ.9 all commands necessary to duplicate the 
current pole/zero configuration. These commands will be executed when an 
INCLUDE PZ.9 command is input. The comment '; this was for stage 4 of filter 5' 
is appended to the file COD. 9 by this same SAVER invocation. The two commas 
after PZ reflect the absence of %2. 

If we define a new macro 

DEFINE MACRO SAVCOD 

APPEND%0COD, ';thiswasforstage',%1, ' off liter' , %2 
EM 

then the following call would add the current contents of the code buffer, followed 
by the same comment used in the last example: 

rSAVCOD COD. 9, 4,5 

: SAVCOD FILE1 , 7 ;This performs just as the ex amp Le 

; above but omits the fi Iter number f rom t he comment , which 

; b e c ome s ' ' this was for stage7offi Iter' ' 

: SAVCOD FILE1 , ,7; These both operate simi Larly to the examples 

; above, but the fi rst omits the stage number 

:SAVC0D FILE1 ; and the second omits both stage and fi Iter 

; numbers . 

Thus the comment arising from the first of the pair above will be 
" ; this was for stage of filter 7" 

and the comment from the last command above will be 
" ; this was for stage of filter" 

The comment embedded in the APPEND command (in the macro body) is used with 
no identifying numbers. 

The last two calls to this macro differ in omitting parameter % 1 or %2. The commas 
delimiting the parameters must be typed even when a parameter will be omitted, if 
there are additional desired or required parameters coming after the omitted ones. 
When no such parameters are required or wanted, as in the last case, the extra 
commas are not needed. 

:SAVER FILE1 ,PZ, ,FILE2,C0DE ;This saves poles and zeros inone 
; fi le and code in another with no comment . 

When you invoke the SAVER macro, you must supply the first and fourth 
parameter, %0 and %3, or the APPEND commands will have no file to append to, 
and this will cause the invocation to abort. If you suppy neither %1 nor %2, the 
default file-objects for the APPEND command will be assumed, which means all the 
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objects denoted by the five keywords will be saved as commands added to the end of 
the file whose name you supplied as %0. The command for this could have been 
simply APPEND filename. Using SAVER, you have the option of also filing the 
code, e.g., 

:SAVERPARAMS. ALL,,, CODFIL, CODE 



Macro Expansion and Syntax Checking 

The syntax and semantics of the commands in a macro block are ignored at the point 
of definition; they are not determined until invocation, and may be different on each 
invocation through the use of formal parameters. 



When a macro is called, its definition is expanded by replacing the formal 
parameters in the definition, using the text of the actual parameters in the call. If the 
expanded macro contains any calls to other macros, the text of any such macro is 
also expanded, forming in effect one overall block of commands. The results of 
expansion are displayed at the console. Expansion continues until the last EM is 
reached. If the expansion results in a set of complete, valid commands, the 
commands are executed. An error results if any command is incomplete or invalid 
after expansion. Examples of macro expansion and syntax checking appear in 
Chapters 10 and 11. 



Displaying or Removing Macros 

— »>(dir macro)— ► 
Macro Directory 

-(REMOVE MACRO)-*- 



c 



c 



MACRO 



— »» f macronamej- 



macroname: : = an identifier appearing as above in a legal 
def ine-macro command 



Remove or Dispaly Macros 121533 -21 

The DIR MACRO command lists the names (but not the bodies) of all macros 
currently defined. Macro bodies may be displayed by typing a list of one or more 
macro-names after the keyword MACRO, followed by the usual carriage-return. 
Similarly, macros may be removed by typing a list of one or more macro-names 
after the keywords REMOVE MACROS. If no list follows MACRO or REMOVE 
MACRO, then all current macros are displayed or removed, respectively. 

Examples of these commands appear in Chapters 10 and 1 1 . 
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Controlling a Loop: REPEAT, COUNT, 
WHILE, and UNTIL 
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■+-Q UNTIL^-»J 
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END 



REPEAT, COUNT, WHILE, and UNTIL 
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These compound commands permit the blocks of contained commands to be 
executed indefinitely, a specific number of times, or conditionally. REPEAT or 
COUNT commands may contain any number of conditional exits using the keyword 
phrases WHILE condition-expression or UNTIL condition-expression. The 
paragraphs that follow give explanations and examples of the use of these 
commands and modifying phrases. 

As the charts above indicate, these loop control commands begin with the word 
REPEAT or the phrase COUNT integer-expression, meaning any expression which 
evaluates to a positive integer quantity. This quantity is evaluated immediately and 
used as the number of iterations (maximum) for the commands contained in the 
command block that follows. REPEAT has no such limit. (You can use the ESCape 
key to abort command processing, returning you to the Compiler.) 

The command block may have in it any number of any commands except DEFINE 
MACRO or REMOVE MACRO. The Compiler's awareness that you are entering 
commands within a compound command is shown by the period it types at the 
beginning of each such line. If a new compound command is begun as part of defin- 
ing a prior compound command, a second period (and third, etc., as needed) is 
typed by the Compiler to indicate the nesting. Each REPEAT or COUNT ends with 
an END statement. 

A macro invoked in a REPEAT or COUNT command is expanded immediately 
after the macro call command is entered. Thus, a macro called in a REPEAT or 
COUNT command is expanded only once, though perhaps used repeatedly 
thereafter. 

If the block of commands within a compound command is to continue executing 
only under certain conditions, you can use the WHILE or UNTIL clause to specify 
them. This can involve a wider class of expressions than the arithmetic ones 
explained in Chapter 2. The full range of legal expressions is discussed in the next 
section, after which the discussion of compound commands is continued. 



Relational and Boolean Expressions 

Relational expressions involve a comparison of the values of two objects, using these 
relational operators: 



< 


Less than 


= 


Equal to 


> 


Greater than 


<= 


Less or equal 


<> 


Not equal 


>= 


Greater or equal 
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Relational expressions are evaluated to a FALSE or TRUE value, meaning the least 
significant bit of the values is or 1 , respectively. 

Examples: 

GAINC60) < .GAIN_LAST_POLE 
ANGLE(POLEI) >ANGLE(P0LE4) 
. FIRST_VALUE <= .NEXT_VALUE 

Boolean expressions represent combinations of TRUE and FALSE values using con- 
junction (AND), disjunction (OR), negation (NOT), and exclusive-disjunction 
(XOR). As an example, 

X<PI AND NOT X<0 

is either true or false for any given value of X. The operands for the boolean 
operators can be any integer or relational expression. 

Examples: 

AGAIN (250) < .AGAIN_LAST ANDMAGAIN<300 
INST <9 OR MSQE < 1 47 



I— C not y -t' 



■o- 

-o 



^-■-(primary)- 



-CUD- 



~CZD- 



GEiD 



( MASK ) 






-cz>- 



-CZZ>~ 



-cz> 



d- 



-CZD- 



•cz>* 



( AND ) ( OR ) ^ XOR ) 



Expression 
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WHILE and UNTIL (Continued) 

After the WHILE or UNTIL you place a boolean or relational-expression, which is 
evaluated to a FALSE or TRUE value. (Actually, any integer-valued expression is 
legal. FALSE means the lowest-order bit was a 0, TRUE, a 1 .) 

The WHILE clause terminates execution of the loop upon a value of FALSE; the 
UNTIL clause does so upon a value of TRUE. The commands in a block continue to 
be executed until one of these clauses causes a halt or until the count limit is reached. 
Execution then continues after the END for that block. 
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In both the WHILE and UNTIL clauses, the relational-expression is evaluated each 
time the clause is encountered, i.e., once per iteration. Evaluation at each iteration 
involves looking up the values of any references in the expression. Thus, the result 
can change with each evaluation. 

This is different from the expression that follows an exterior COUNT, which is 
evaluated once, the first time it is encountered. (A COUNT embedded within a 
WHILE or UNTIL clause could use an expression dependent on varying variable 
references. Its value would nevertheless be fixed for the block of commands under 
its control.) 

The use of WHILE or UNTIL is usually a matter of style or preference, since there is 

always a way to convert one into the other: WHILE expression 1 is equivalent to 

UNTIL NOT expression 1. If the expression 1 used in this "escape" clause is 

false, the loop is exited as soon as this is evaluted. If the clause comes at the end of 
the command block it affects, the prior commands in the block will be done once 
even when the expression is false. If the clause comes first, no commands in the 
block are done. 

Examples: 

REPEAT 

GRAPH GAIN 

MOVE PZ BY 0.005,0.005 
END 



C0UNT5 

CODE POLE . NEXT PERR0R< 1,1 

APPEND FILCOD. 819 CODE 

APPENDFILC0D.819 ' ;THEAB0VEC0DEWASF0RP0LE ', .NEXT 

.NEXT = .NEXT + 1 
END 

( . NEXT is assumed to be initialized prior to the above commands . ) 

REPEAT 

GRAPH GAIN 
UNTIL GAINC655) <= 80 

MOVE PZ BY 5,5 
END 

COUNT 5 

WHILE .NEXT <16 

CODE POLE .NEXT PERROR < 1 ,1 

APPEND FILCOD. 819 CODE 

APPENDFILC0D.819 ';THEAB0VEC0DEWASF0RP0LE ', .NEXT 

.NEXT = .NEXT + 1 
END 
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The IF Command 



-f IFexp J—i ( cr J — r-*- (command crY 

L ( THEN > J I 



-{ORIF expression)^ 



C ELSEcr J i-^fcommand crV 



T- C END ) -» 



The IF Command 
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This compound command permits you to specify blocks of commands whose execu- 
tion is contingent upon tests of certain values or relationships. It is a powerful 
capability, making it possible to specify in advance the consequences you wish to 
invoke under varying circumstances, e.g., error variances. 

This command must have the IF clause and the final END. The word THEN is 
optional. There may be any number of ORIF clauses, or none, and one ELSE 
clause, or none. The expression following IF is evaluated to FALSE or TRUE. If it 
is TRUE, the command block immediately following is executed, and subsequent 
ORIF or ELSE expressions are ignored along with their associated command blocks. 

If the IF expression evaluates to FALSE, the next sequential ORIF or ELSE expres- 
sion is evaluated, with similar consequences: if this expression evaluates TRUE, only 
its command block is executed and all other parts of the IF command are skipped. A 
macro called in an IF command is expanded whether the condition in the IF or ORIF 
clause that contains that call is TRUE or FALSE. Here is a simple example of an IF 
command: 

.VAR8 = 1 .4142 

. LIMT = 1 

IF . VAR8 < . LIMT THEN 

EVALUATE .VAR8/PI ; PI =3.1415926 
ORIF .VAR8 <2 

EVALUATE. VAR8/HPI;HPI = 1 .7 07963 
ORIF .VAR8 <3 

EVALUATE .VAR8/TPI ; TPI =6.2831852 
ELSE 

EVALUATE .VAR8/(PI * PI) 
END 

This example would display the result of EVALUATE .VAR8/HPI and then 
terminate. The first condition is FALSE so the first potential consequence is 
skipped. The second condition is true, so the second command block is executed and 
the IF command terminates. The third condition is not tested, so its associated 
command block is not executed despite the condition being true. 
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Another Example: 



♦DEFINE MACRO COMPARE 

* IF%0<%1THEN 

* WRITE ' LESS ' 

* ORIF %0 = %1 THEN 

* WRITE ' EQUAL' 

* ELSE 

* WRITE 'GREATER 

* END 
*EM 



This macro can later be invoked with any two actual parameters, e.g., 



* :C0MPARE .VAR8, . LIMT 

* IF .VAR8 < . LIMT THEN 

* WRITE ' LESS' 

* ORIF .VAR8 = . LIMT THEN 

* WRITE ' EQUAL' 

* ELSE 

* WRITE 'GREATER' 
GREATER 

* :C0MPARE . LIMT, .VAR8 

* IF . LIMT < .VAR8THEN 

* WRITE ■ LESS ' 

* ORIF . LIMT = .VAR8 THEN 

* WRITE 'EQUAL' 

* ELSE 

* WRITE 'GREATER' 
LESS 

* :COMPARE PI, TPI/2 

* IF PI <TPI/2 THEN 

* WRITE ' LESS' 

* ORIF PI =TPI/2 THEN 

* WRITE ' EQUAL' 

* ELSE 

* WRITE 'GREATER' 
EQUAL 



This example displays the expansion of the macro each time, and the result of 
comparing the two actual parameters. The IF/ORIF/ELSE blocks cause execution 
of only one block, so that the output of COMPARE can only be 'LESS', 'EQUAL', 
or 'GREATER'. 



Nesting Compound Commands 



The REPEAT, COUNT, and IF commands can be nested to provide a variety of 
control structures. 

Each nested compound command must have its own END. When entering a nested 
command sequence, you may wish to use the keywords ENDR, ENDC, and ENDIF 
to help you keep straight which command you intend to close off at that point. 
Nesting levels are not checked when the command is being entered, and if an END is 
omitted, the resulting error makes it necessary to enter the entire command again. 
Further, even if the correct number of ENDs is supplied, their position in the 
command sequence is critical to achieving your intended flow of control. 
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When entering a compound command, some syntax errors allow recovery to the 
state at the last prompt. You can recognize such recovery by the ...* prompt, 
indicating you are still within the definition phase of entry. Other syntax errors are 
fatal, requiring you to retype the entire command. This you can recognize by the * 
prompt. 

Each nested REPEAT or COUNT command can contain its own exit clauses 
(WHILE or UNTIL). Each such exit clause can terminate the loop that contains it, 
but has no effect on any outer loops or commands. 



Examples of nesting appear in Chapters 10 and 1 1 . 
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CHAPTER 10 
ADVANCED TECHNIQUES: FILTER 

DESIGN EXAMPLES 



Introduction 

As Chapter 9 has illustrated, the macro capability is a powerful tool, enabling you to 
define command sequences under a single name and then use that name as a new 
command. There are few restrictions on these sequences, allowing very general 
routines to be created. Parameters you may wish to vary from one use to the next 
can be built into the sequence as formals, to be supplied at the time of use, i.e., 
macro invocation. This permits tailored sequences to be produced from the general 
pattern you developed. 

As with any general-purpose computer feature, the ingenuity of user-developed 
applications for this macro capability cannot be fully defined or predicted. It greatly 
extends the range of the signal processing Compiler language. 

Examples of useful macros directly relevant to filter design comprise the main body 
of this chapter. More general examples, applicable to a wider range of signal 
processing requirements, appear in Chapter 11. All of these examples can be 
replicated for other filters or other operations once you see the process for defining 
and generating them. Their use as models is one of the main motivations for supply- 
ing them, in addition to their intrinsic utility. The ones you want for immediate use 
shoulde be edited from the supplied file SPAC20.MAC into a separate file to 
conserve space when they are later INCLUDEd. 

The first two macros given in this chapter produce Butterworth and Chebyshev 
filters based on user-supplied parameters for cut-off frequency, ripple, etc. The 
Bilinear transform macro performs S to Z transformation. The last macro produces 
code for the current state of an entire filter: each pole and zero, plus A to D and D to 
A conversion. 

a 

These are Intel-supplied macros, and appear in the file SPAC20.MAC. They have 
been checked for correct functionality, i.e., that given the right input in the correct 
order, they will produce the described output. 

They are, however, macros as opposed to commands. As such, the degree of error 
checking is not (and cannot be) as extensive as for the basic set of built-in 
commands. If the parameters supplied are not of the correct type or not in the 
proper order, the results cannot be fully predicted or guaranteed; it is conceivable 
that prior work could be altered or erased. 

It is therefore extremely important, before using any macro, to understand its 
expectations, as reflected in the nature and order of the parameters to be supplied. 
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* i HC 



*** B<JTTERWORTH FILTER RftCPO ***> 
: Fl : BUTTER. MAC 



*DEF!NE MACRO BUTTER ;**************************************** 
: T his is a BUTTERUORTH FILTER GEHERATOR for SPAC20; 

Calling sequence :BUTTER ORDER, Fco, LABEL where 
: BUTTER calls the MACRO, 
ORDER is the order of the filter 
Fco is the cut-off frequency in Hz 
LABEL is starting point for POLE numbering. 



EXAMPLE 



iBUTTER 6.500,234 
this will generate a BUTTERWORTH filter 
of order 6, cutoff=500 Hz , producing 
3 conplex poles labeled 234,235,236 



* E 

* R 

* R 

* R 

* "R 

*r 2 
*EH 



EFIHE . 

EFIHE . 

EFINE 

EFIHE . 

EPEAT 
. ?BUTI 
. ?BUTA 
IF .?B 

END 
DEF PO 

WHILE 

riD 



7BUTSTART = < HPI > + 
7BUTDELTA = < PI/HO > 
7BUTINDEX = 
7BUTAHGLE = 



< HPI/XO ) 



', ** 



7BU 
7BU 
7BU 
?8U 



NDEX = 7BUTINDE 
HGLE = . 7BUTSTAR 
UTAHGLE < 7BUTD 
?BUTANGLE=0 

L< . 7BUTINDEX+X2- 

*1*SIH 

7BUTINDEX + 1 < 

TANGLE 
TINDEX 
TDELTA 
TSTART 



** BEGIN THE 
** BUTTERUORTH 
INITIALI2 
VARIABLES 
;** BEGIN LOOPJ 
;** CORRECT FO 
7BUTDELTA i * SMAL 
;** ANGLE ERRO 
; ** 

;** NOW CREATE 
1) = -5il*C0S< . ?BUTANGLE>,& THE 



X + 1 

T - . 7BUTINDEX 

ELTA/4 THEN 



< -?BUTAHGLE> 
= ( XO + 1 > 



.: ******************** 



;** NEXT POLE 
;** CONTINUE ? 
;** END OF LOOP 
;** REMOVE ALL 
J** VARIABLES 
;** OF THIS MAC 
;**DISPL6Y POLE 
Jt*END BUTTERttO 

*********************************** 



********* 




*** 




■»** 




*** 




*** 




*** 




*** 




*** 




*** 




*** 




*** 




• ** 


i 


*** 


E 


*** 


; 


*** 




*** 


R 


*** 


L 


*** 


RJ 


*** 




*** 




*** 




** * 


) 


*** 




*** 


j 


**4 




*** 




*** 


RO; 


*** 


S; 


*** 


RTH 


*** 



********** 



* ; an 

* ; c i 

* > it 

* >' . 

* :8U 



This macro generates a 8utterworth filter with the cuto 
d the order specified. Poles and zeroes are placed in the 
rcle centered around the origin. The following exanple il 
i s i nvoked 

TTER 7, 1000, ; creates a ?th order filter ..cutoff = 1000 hz 



ff frequency 
S pi tne in a 
lustrates how 



(Theexpansionhasbeendeleted.) 



10-2 



SPAC20 Compiler 



Advanced Techniques: Filter Design Examples 



POlE = -222. 52087,974.92791 , CONTINUOUS 

POLE 1 = -623. 48980,781 .83148, CONTINUOUS 

POLE 2 = -900.96893,433. 88366, CONTINUOUS 

POLE 3 ■ -1000 .00000,0.00000000, CONTINUOUS; REAL 

*; ithe nocro expansion has been suppressed here 

*.:the macro outputs the PZ< poles and zeroes) it has generated 

*;Let's look at the response 

*FSC=10,200, 400, 600 ,800, 1000, 1200, 1400 ;set new frequency range 

*Y-$C=-25, 1 ;set new vertical scale 

*GftA GAIN 



GAIN 

1 



-4 


J 


-5 


2 


- ■» 


4 


-■» 


? 


--J 


d 


-10 


1 


-l i 


4 


-12 


6 


-1"S 


a 


-15 


1 


-ii 


3 


-1? 


6 


-IS 


8 


-20 






■25. 



t'B IH2 i ...--.... \ 



10 30 200 300 400 500 600 700 800 890 1000 1110 1200 1310 1400 
*;The filter exhibits a naxinally flat response characteristic in the pass band 
*;<is expected 
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' r •» n 11 aero 

•REM PZ 

: POLES/ZEROES REMOVED 

.;---** CHEBYSHEY FILTER MACRO 

> •' A CHEBYSHEV FILTER GENE 

'■ CALLING SEQUENCE :CHEB ORD 

* ■■ WHERE ORDER is the order of 

* : Fco is the cutoff fre 

► ; LABEL is the storting 

t '■ R.F. is the desired < 



***** 
RftTOR FOR SPAC20 

ER, Fco. LABEL, R.F. 

the f i Iter 
quency in Hz 

point for pole numbering 
or allowable) ripple factor in dB 



** 
** 
** 
** 
** 



EXAMPLE 



iCHEB 6,50 

this W i 1 

6, cutof 
dB/ prod 



0,23,0 . 12 

I generate a CHEBYSHEV filter of order ** 
f=500,and a peak-to-peak ripple of 0.12 ** 
ucing 3 conplex poles labeled 23/24,25 ** 



F ?C 
F . ?8 
F . ?C 
F . ?C 
: TE 
ND 

n . ?c 

EFINE 

EFINE 

EFINE 

EFINE 

EPEAT 

. ?BU 

. ?BU 

IF 

EN 

DEF 



HEBYR 
INHP= 
0SHP = 
HEBYR 
MCHB 

HEBYR 

. ?BU 

. ?BU 

. ?BU 

?BU 

TINDE 
TANGL 
. ?BU 
. ?B 
D 
P0L( . 



IP=10**< ABS<*3>/10>-1 

1 

1 

IP <> THEN 

.7SINHP, .7C0SHP, . ?CHEBYRIP,XO 



WHILE 
HD 



7BUTIN 
7BUTDE 
7BUTST 
7BUTAN 
7SINHP 
.7C0SHP 



IP 

TSTART = < HPI > 

TDELTA = < PI/5C0 

TINDEX * 

TANGLE=0 

X = . 7BUTINDEX + 
E=.?BUTSTART - .? 
TANGLE < 7BUTDEL 
UTANGLE=0 

?BUTINDEX+X2-1>= 
X1*.?SINHP*C0S< .? 
XI* .?C0SHP*S 
UTINDEX + 1 <= ( 

DEX 
LTA 
ART 
GLE 



+ ( HPI/XO > 
> 



1 

BUTINDEX*.?BUTDELTA 
TA/4 THEN 



BUT ANGLE), «= 

IN< .7BUTANGLE ) 
5J0 + 1 ) / 2 



* BEGIN THE ** 

* CHEBYSHEV ** 

* BY SETTING ** 

* DEFAULT VALUES, ** 
** OR USE THE ** 
** SUB-MACRO ** 
** TO GENERATE ** 
** THE VARIABLES. ** 
** ** 

* A MODIFIED ** 

* BUTTERHORTH ** 

* MODULE IS ** 

* INCORPORATED ** 

* TO GENERATE ** 

* THE APPROPRIATE ** 

* PATTERN OF ** 

* POLES FOR THE ** 

* FILTER . (the fcs ** 

,' * allow greater ** 
i * readability of ** 

* the fornula . > ** 



TE 
'EF M 
'J CA 

'DEF 

■DEF 

'DEF 

«5i0=< 

i '-;!=( 

'REM 

'REM 

'REM 

■EM 



MCHB GET VARIABLES FO 

AC TEMCHB 

LLING SEQUENCE 

iTEMCHB SINHP,C0SHP,E 
?INVSXTEMP=( l/SQR<X2)> + ( 
?INVSXTEMPP= 7INVSXTEMP 
?INVSXTEMPN= . 7INVSXTEMP 



?INVSXTEMPP 

7INVSXTEHPP 

?INVSXTEMP 

?INVSXTEMPP 

?INVSXTEMPN 



71NVSXTEM 
7INVSXTEN 



J** REMOVE THE ** 

J** VARIABLES ** 

;** INTRODUCED ** 

:■** IN THIS MACRO, ** 

;** TO SAVE SPACE. ** 

; ** ** 

;******* E HD OF CHEBYSHEV MACRO ******** 

R CHEBYSHEV FILTER »*••*« t iff it * tff M* t**t 



**2,N 

SQR<< 1/X2>+1 )> 

**( l/*3> 

**( -1/X3 ) 

PN>/2 

PN)/2 



*• 


THIS 


IS 


THE 


#«« 


** 


SUB- 


1ACR0. 


*•* 










>### 










,'### 










;### 


; ft 


END 


OF 


TEMCHB 


tit 



*.sThis macro generates a Chebys 
*;and peak-to-peak ripple as sp 
*;how the nacro nay be invoked: 
*:.Cfl£B 7,1000,0,3 J?th order 1000 Hz filter, p-p ripple=3 



hev filter with the order, cutoff frequency 
ecified. The following is an example of 



(Theexpansionhasbeendeleted.) 
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POLE « -28.145643,982.69361 .CONTINUOUS 

POLE 1 » -78. 862358, 788. 06072, CONTINUOUS 

POLE 2 = -113. 959419, 437. 34060, CONTINUOUS 

POLE 3 * -126. 485404,0 .00000000, CONTINUOUS; REAL 

*.iThe nacro expansion has been suppressed 

* i 

*;i.et's look at the response 

♦ OGR GAIN 



GAIN 


i 


A | A | 


A | A | 


A , A | A | 






. .4444444444444444. 


. . 44444444444444 . . 




- .3 2 




' ' - . - ' 


' - . . ' - 


- . 4444 - 


- . *< 




. . ' 


' . 


. + t 


- ?. " 




, , , , , 


.-,,,, 


' ' ' - + 


-4.0 








44 


-5. 2 








+ 


-6 4 








+ 


-?. ? 








+ 4 


-3. 9 








+ 


-10.3 








+ 


-11.4 








' 4 


-12.6 








44 


-13.9 








4 


-15.1 








4 


-16.3 








44 


-f 6 








4 


-13 8 








4 


-20.0 








44 


-2! 3 










-22 5 










-23 S 










-25 








************** 


DB 1 HZ 


i 


A , A | 


A | A | 


A | A | A | 




10 


30 200 300 400 


500 600 700 800 


890 1000 1110 1200 1310 1400 



*;Th* plus signs represent the old gain curve of the Butterworth filter. 
*;The peak-to-peak ripple is 3dB as specified and the dropoff is faster than 
*;th* Butterworth filter 
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* ! HC i 



* BILI 
F 1 : BI T 



NEAR TRANSFORM MACRO 
RAH. MAC 



*DEF MACRO BTP 

;This mcro generates a Bilinear 
;Calling sequence sBTP 
.EXAMPLE :BTP 



• BLTCOM !!0, X\ , POLE, ZER( 

*EM 



transform of a given pole 
POLE * IN S, POLE t IN Z 
3,90 

this will take a pole in the S plane, <P 3) 
and produce a pole in the Z plane <P 90 > 
and 1 or 2 extra zeroes <Z 90 / Z 91 ) 
depending on whether P 3 is a real pole or conplex 



*DEF 

: Th 



* : BL 
*EM 



MACRO BTZ 

is nacro generates a bilinear transform of a given zero 

.Calling sequence :BTZ ZERO * IN S, ZERO i IN Z 

;EXAMPLE :BTZ 3,90 

i this Mill ttke t zero in the S pUnt, (Z 3) 

1 and produce a zero in the Z plane <Z 90 > 

; and I or 2 extra poles < P 90 / P 91> 

; depending on whether Z 3 is real or complex 

TCOM SO, XI. ZERO, POLE 



*D£F 


MACRO 


. * ; S 


UB MAC 


. * : 




. *IF 


ABSCCO 


. * 


REM 


. * 


X5= 


. * 


IF 


. *nov 


XZ X 


. * 


ELS 


. *«ov 


XZ X 


. * 


END 


. *END 




. *Et1 




* .'. 





CKREAL 

RO used in another sub-nacro BLTCOM to check for real pole/zero and adjust 

angle etc 
S<TPI*IMAG<5S2 540 >> >= 1 THEN 

XZ 5sl+l JREHOVE EXTRA PZ 

SQR<5J5> JADJUST SCALE FACTOR 

REALCS2 5SOXX4 THEN ; ADJUST ANGLE 

1 TO RAD<X2 XI ),0 
E 
1 TO RAD<^.2 XI ),PI 



*D£F MACRO BLTCOM 

This nacro is called from BTP/BTZ, which supply pole/zero 
labels .and the proper ' pol e ' / ' zero ' 



THE TRANSFORM EQUATION HERE IS 

S = (C > * < 1-Z**-1 > / < 1 



Z**- i > 



*0>EF 
*DEF 
*f>£F 

*0£F . 

*0EF . 

* £>£ F . 
*J>EF . 
*0EF . 
*!>EF X 
*0EF X 
*£>£F X 

* : 

* • ADJU 

* :CICRE 



?QC = 2/TS;This is the constant C used <n this nacro 

?QA = - REAL (.XZ XO ) 

?QB = I MAG < XZ *0> 

?QA0 = <.?QC + ?QA>**2 + . ?QB **2 

?QA1 = 2*<.?QA**2 + .?QB**2 - .?QC**2> 

?QA2 = < . ?8C-.?QA >**2 + ?QB**2 

7QRADIUS = SQR < . ^0 A2/ . ? Q AO > 

?QAHGLE = ACOS C-.7QA1/ < . ?GA0*2* . ?CR ADI US > ) 

2 XI = ?QRADIUS, .7QANGLE, Z 

3 XI = 1, PI , Z 

3 < X I + 1 > = 1 , PI, Z 

ST FOR REAL IF NECESSARY 
AL XO.Xl.XZ, XZ. .?QC, .?QAQ 



*«JRITE 'SCALE FACTOR 



1/ ?6A0 
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*REf1 

*REM 
*REN 
*REH 
*REM 
*REH 
*REM 
♦ REM 
*EM 



?QC 

?QA 

?QB 

?QA0 

?QA1 

?QA2 

7QRADIUS 

7QANGLE 



*; Th is 

* ; the 

* ; or z 

* l <4 ! 11 

* ; i , P I 

* ; 

♦JFirs 
* ; then 

* ; L e t ' 

* ; of 1 

* iF i rs 
*RE!1 P 
4 POLE 
*TS=1/ 
TS = 1 
* :CHEB 



macro performs a Bilinear transform and takes a pole/zero in 
S plane and generates a pole/zero in the Z ptane. Additional poles 
ero«t nay be added to the point 1,PI in the 2 plane. The user 

have to cancel poles and zeroes that lie on top of each other <at the 

point on the Z plane )nanually. 

Let us try to generate a 1000 Hz Chebyshev filter in the 2 plane 
t, we have to warp the frequency * and obtain an analog filter 

we can proceed to design a digital filter by a Bilinear transforn. 
s design a digital Chebyshev 7th order filter with a cutoff frequency 
000 hz and 3dB ripple 

t we obtain a preuarped analog filter 
•? 

S/ZER0ES REMOVED 
8000 

. 24999975/10**4 
?,2/TS*TAN<PI*TS*1000>,0,3 



(The expansion has been deleted.) 



-18653 2 92, 6512. 7338, CONTINUOUS 
-522.65380,3 222 . 80 76 , C0NT INU0US 
-7 55. 25665,2898 . 4389 , C0NT INU0US 
-8 38. 27160,0 . 00000000, CONTINUOUS. 

*; INVOKE THE BILINEAR TRANSF0RH NACR0 

* :8TP 0, 1000 



POLE 
POLE 1 
POLE 2 
POLE 3 



REAL 



(The expansion has been deleted.) 

SCALE FACTOR » 3.3302805/10**9 
*-'ST.P 2,1200 

(The expansion has been deleted.) 

SCALE FACTOR = 3.2849423/10**9 
*!BTP 1,1100 

(The expansion has been de leted. ) 

SCALE FACTOR = 3.3302805/10**9 
*:STP 2,1200 

(The expansion has beendeleted.) 

SCALE FACTOR = 3.4583420/10**9 
*:BTP 3,1300 



(The expansion has beendeleted.) 
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1 POLES/ZEROES REMOVED 

1 POLES/ZEROES MOVED 

SCALE FACTOR » 5.9388589/10**5 

* ; 
*P2 

POLE - -186. 53292,6512 7338, CONTINUOUS 

POLE 1 * -522. 65380, 5222. 8076, CONTINUOUS 

POLE 2 = -755. 25665, 2898. 4389, CONTINUOUS 

POLE 3 * -638. 27160, 0.00000000, CONTINUOUS; REAL 

POLE 1000 = 0.98019560,0. 77321420, Z 

POLE 1100 « 0.94265810,0. 63161171, Z 

POLE 1200 ■ 0.91259267,0.35917749,2 

POLE 1300 = 0.90043251,0. 00000000, Z; REAL 

ZERO 1000 * 1.00000000,3.1415927,2; REAL 

ZERO 1001 « 1.00000000,3.1415927,2; REAL 

ZERO 1100 - 1.00000000,3.1415927,2; REAL 

ZERO 1101 - 1. 00000000,3. 1415927, Z; REAL 

ZERO 1200 - 1 .00000000,3 .1415927, Z J REAL 

ZERO 1201 = 1.00000000,3.1415927,2; REAL 

ZERO 1300 = 1.00000000, 3. 1415927, Z; REAL 

*5the poles labeled to 3 have been transformed to those PZ labeled 1000-1302 

*;Let's conpare with the analog Chebushev filter 

* > 

*;Let's conpare the gain with the analog Chebyshev filter 

*REI1 P THR 3 

4 POLES/ZEROES REN0VE& 

•OCR GAIN 



GAIN ! ... A ....!....*....!.... A ....!... A ....!... A ! .... A ....!.... A .... ! 

1.0 .... + . . . + . 

-0.2 ' ' - +.''+'-. +_<'_ 

-1.5 '. +.-' +'. +.' '.. 

-2.7 ,,,,,, + , , , , , + , , , 

-4 

-5.2 

-<i 4 + 

- ? 7 ' 

-3 9 

- 1 ' 1 
-11.4 
-12* 

-13 9 + 

-15 1 

- 1 •» 3 

-17.6 + 

-18.3 

-20.0 + 

-21.3 

-22 5 '+ 

-23.8 

-25.0 -»*#»♦♦****»*♦* 

DB I HZ ! ... A ....!.... A ....!.... A ....!..."....!... A ! .... A ....!.... A .... ! 

10 30 200 300 400 500 600 700 800 890 1000 1110 1200 1310 1400 
* ; 
*;Th« plus sign represents the points where the old curve differs 
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* ; 



* MACRO TO CODE AN ALL-POLE FILTER 
FUCODFIL.HAC 



♦ IMC 

* i 

♦DEFINE HAC*0 COOFIL 

♦ ; 



♦;MACRO to code an all-pole filter/ with all poles 
labeled consecutively starting at 0. 
Scale factors will be approximated fron HAGAIH 
The connent generated assuned that the PZ are in the TS plane* 
and therefore output the PZ position in cartesian coordinates 



* ; 
* ; 
♦ ; 

* ; 

* .: 
♦-WARNING 

* ; 
♦ ; 
♦ ; 
♦ ; 

* :CAL 
tCODF 
* ; 

* ;EX. 

* ; 
♦ ; 

* : 



THERE IS A ( REM PZ > COMMAND UHICH HILL REMOVE ALL YOUR 

PZ FROM THIS SESSION. THE PZ AFTER CODING UILL HAVE BEEN SAVED 

IN A NEWLY CREATED FILE TEMPXX.THP 



LING SEQUENCE 

IL FILENAME/ NO. OF POLES/ CONSTRAINT 

sCODFIL LOPAS.SRCz 10/ INSTOO 

this will code all poles labeled through 9, and all code 

generated will be appended to the file LOPAS.SRC. Each pole 

is coded with the constraint INST<10. In addition/ scaling 

factors required between stages are also approximated fron 

NAGAIN > and docunented in the output file. 

XO '; 



* ; 

♦ : 

*APP 
♦*;START OF CODE GENERATED BY MACRO CODFIL 

♦ ♦; 

♦ *; ' 

* :FHEl 
*D£F 

♦ ; 

♦ : 

♦ COUN 

♦ APPE 

♦ APPE 

♦ CODE 

♦ APPE 

♦ APPE 

♦ APPE 

♦ ?QI 

♦ END; 

♦ : 

♦ ; 

♦ APPE 

♦ «J8E 

♦ •iPL 

♦ ♦.! ' 

♦ PUT 

♦ WRIT 

♦ ; 



:ad xo 
?qi»o 



T 5CUSTART LOOP FOR CODE GENERATION 

ND XO ' ; ' 

ND XO 'JCODE FOR POLE ',.791,' AT '/REAL<P .?QI>,', ',INAG<P .?8I> 

POLE ?Ql %2 
ND 550 CODE 

ND SCO '; ABOVE CODE MOVED POLE ',.?QI/' TO ' / REAL( P ?8I>/' , '.IHAGCP .?QI) 
ND SCO '; ' 
= .?QI + 1 
END OF LOOP FOR CODE GENERATION 



ND XO ' ; 

SURE TO DO THE FOLLOWING SCALING FOR EACH STAGE 
US ANY OTHER SCALING COMMENTED IN THE GENERATED CODE 

TEMPXX.THP PZ;SAVE ALL PZ 

E 'PZ SAVED IN TEMPORARY FILE' 



♦iQSFAC X0/X1 



JGET SCALE FACTORS 



♦ APP 

♦ REN 

* ; 

♦ WRIT 
** 

** 

♦ * 

♦ * 
** 

♦ *' 

♦ EM 



*0 ' JEND OF CODE GENERATED BY MACRO CODFIL 
?QI 

E' THIS MACRO HAS REMOVED ALL PZ. 

THE PZ ARE SAVED IN THE FILE TEHPXX.QQQ 
TO RESTORE ALL PZ FRON THAT STAGE/ TYPE 

INC TEMPXX.THP 
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♦ i 

•DEFINE MACRO QSFAC 

.*', SOB-MACRO TO GET SCALE FACTOR 

. * ; 

.♦; WARNING : IF USED INDEPENDENTLY. THIS WILL REMOVE ALL YOUR P2 

. * : 

.♦; CALLING SEQUENCE :QSFAC FILE-NAME. # OF POLES 

♦ DEF ?QSI=1 

♦ DEF ?8S1=L0G<MAGAIN>/L0G<2>.START APPROXIMATING SCALE FACTOR 
.*DEF ?QFS1=0 

.♦DEF . ?QFS2=0 

♦ DEF . ?QS2=0 

♦ DEF . ?QSO=0 



.♦COUNT Jcl;GET SCALE FACTOR 

♦REM POLE XI- .?OSI 
.♦ ?QFS1=.?QS1 MASK O.FFFFFFH 
.♦IF ?QFS1 <> THEN;ROUND UP 

* ?QS1 = ?QS1 - ?QFS1 + 
.♦END 

* ?QS2«L0G<NAGAIN>/L0G<2> 

.♦ ?QFS2=.?QS2 MASK O.FFFFFFH 
.♦IF ?8FS2 <> THEN;ROUND UP 



. * 


.?es2= 


?QS2 • 


?QF 


♦ END 








.♦ -*QSC 


i=.?QSl- 


?QS2 




.♦APPEND XO ' 


;SHIFT 


RIGHT 


. ♦ ?QS1 


=».?QS2 






. ♦ ?QSI 


».?QSI 


+ 1 




. ♦END 








. ♦ ; 








. * ; 








♦ REM . 


?8SI 






.♦REM . 


?QS1 






.♦REM . 


?QS2 






.♦REM . 


?QSO 






♦ REM . 


?QFS1 






♦ REM . 


?QFS2 






. ♦EM 









INPUT OF POLE • ' »5jl-.?QSI. ' BY ',.?QSQ.' BITS 



♦INC ;Fl:FHEAD.MAC 
♦DEFINE MACRO fHEAD 

♦JMACRO TO GIVE EQU HEADINGS TO FILE 
.♦;This nacro only generates propagation for It stages. 
.♦;for iiore stages. add in the necessary APPEND'S using the Editor 
. * ; 

.♦CALLING SEQUENCE 

.♦: :FHEAD FILENAME 

.♦APP 5:0 ' IN0-P1 EQU OUTO.PO' 

*APP XO ' IN0-P2 EQU 0UT0-P1' 

.♦APP XO ' IN0-P3 EQU 0UT0-P2' 

♦APP 20 ' IN0_P4 EQU 0UT0-P3' 

♦ APP 5:0 ' IN0-P5 EQU 0UT0.P4' 
♦APP XO ' IN0.P6 EQU 0UT0.P5' 
♦APP XO ' IN0.P7 EQU 0UT0-P6' 

♦ APP 3:0 ' IN0-P8 EQU 0UT0-P7' 

♦ APP 5:0 ' IN0-P9 EQU 0UT0-P8' 
•APP XO ' IN0.P10 EQU 0UT0-P9' 

.♦EM 
* 

* ; 

•{Code all the poles of a filter 

• .'First define the poles of this filter 
•TS=l/8000 

TS * 1 . 24999975/ 10*«4 
♦DEFINE POLE 0=- 100 . 1000. TS 
♦DEFINE POLE l=-700 , 1000. TS 
♦:ADC0NV : F 1 : F IL . SRC. I N2 . I NO_PO 



(Theexpansionhasbeendelet e d . ) 
(This macro is explained in Chapter 1 1 .) 
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FILE CREATED* 

* :C0&FIL. :F1 : F IL .SRC, 2, INSKIO 

(The expansion has beendeleted.) 

Bl*i 30739128 B2 =-0 . 854 635 93 

IH5T=4 
POLE = . 00000000, 1999. 9998, TS 

BEST YET 
POLE = -441 .27120,999.99993, TS 

8EST YET 

INST =5 

POLE = . 00000000, 1333. 33325, TS 

POLE = -441 .27120,999.99993, TS 

POLE = . 00000000, 1 140. 39587, TS 

BEST YET 

POLE = -85. 008674, 1999. 9998, TS 

POLE = -85. 008674, 1999 9998, TS 

POLE = -299.21356, 1 128. 18835, TS 



IHST=b 
POLE 0=0 

BEST YET 



00000000, 920. 21374, TS 



00000000, 1 140. 39587 
. 0000 000 0, 1088. 56665. 
-85.008674, 1281 .96582 
-85. 008674, 1281 .96582 
-299 .21356, 1 128. 18835 
-85. 00867 4, 106 8. 3 40 33 



POLE 
POLE 
POLE 
POLE 
POLE 
POLE 

3EST YET 
POLE = -96. 479698, 1999. 9998, TS 
POLE = -96. 479698, 1999. 9998, TS 
POLE = -238.53721, 1 175.851 19, TS 



TS 
TS 
TS 
TS 
TS 
TS 



INST =7 

POLE 

POLE 

POLE 

POLE 

POLE 

POLE 

POLE 



SEST YET 



POLE 

POLE 

POLE 

POLE 

POLE 

POLE 

POLE 



0.0000 0000,9 78.8582 7, TS 
. 0000000 0, 108 8. S 6665, TS 
0. 0000000 0, 1092. 88586, TS 
-8 5. 008674, 1068. 340 33, TS 
-8 5.00867 4, 1068. 340 33, TS 
-8 5.00867 4, 1 068 . 3 40 33 , TS 
-85.00867 4, 1 009 . 94763 , TS 

r 

-9 6.47 969 8, 1274. 664 79, TS 
-9 6.47969 8, 1274.6 64 79, TS 
-238.53721, 1 175.851 19, TS 
-132. 18 73 32, 1024. 49 133, TS 
-100.02 75 95, 1999.99 98, TS 
-9 9. 379959, 1999. 9 998, TS 
-2 45 .8130 3, 1 17 0. 3 2641 , TS 



IMST = 
POLE 
POLE 
POLE 
POLE 
POLE 
POLE 
POLE 
POLE 
POLE 
POLE 
POLE 



.00000000,993.08331, TS 
0. 00000000, 1092. 8 8586, TS 
0.00000000, 109 2. 88586, TS 
-85.00867 4, 1009 947 63, TS 
-8 5.00867 4, 1 009 . 94763 , TS 
-85.00867 4, 1 009 . 947 63 , TS 
-85. 008674, 1 01 4 . 834 71 , TS 
-96. 479698, 105 7. 95434, TS 
-96.479698, 1 05 7 . 954 34 , TS 
-132.18 73 32, 1024. 49 13 3, TS 
-96.479698,998.5529 7, TS 



BEST YET 
POLE = -100.027595, 1272. 38793, TS 
POLE = -99.379959, 1272.80419, TS 
POLE = -245.81303, 1 170. 32641, TS 
POLE = -129.134002, 1027. 42260, TS 
POLE = -100.004852, 1999. 9998, TS 
POLE Q - -100.107147, 1999. 9998, TS 
POLS = -247 .64495, 1 168. 92749, TS 
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POLE = . 00000000, 1000. 13574, TS 

POLE = . 00000000, 1092. 83586, TS 

POLE = -85. 008674, 1002. 46459, TS 

POLE = -8 5. 008 67 4, 1002 . 4 64 59, TS 

PQLE = -85. 008674, 1014 .83471 , TS 

POlE = -85. 008674.- 1014 . 83471 , TS 

POLE = -96. 479698,998 .55297, TS 

POLE = -96. 479698,998 .55297, TS 

POLE = -96. 479698,998 .55297, TS 

POLE = -96. 479698, 1003.52844, TS 

POLE = -100 .027595, 1054 . 70727, TS 

POLE = -99. 379959, 1055. 30126, TS 

POLE = -129 . 134002, 1027 . 42260, TS 

POLE = -97. 203498,997 .82714, TS 

BELT YET 

POLE = -100 .004852, 1272. 40246, TS 

POLE = -100 . 107147, 1272. 33679, TS 

POLE = -247 .64495, 1168. 92749, TS 

POLE = -127 .612823, 1028 .87805, TS 

POLE = -100 .008880, 1999.9998, TS 

POLE = -100 .016181 , 1999 . 9998, TS 

POLE = -248 . 10377, 1168. 57666, TS 

IHS'=9 
POLE = -97.203498,997 82714, TS 
8E-M 
PERROR = -2.7965011, 2.1728515 

; HO'E; MAKE SURE SIGNAL IS <0. 76190478 
LDA OUT2-P0, 0UT1_P0,R0G 

0UT2_P0=1 00000000*OUT1_PO 
LDA GUTi.PO, OUTO-PO, ROO 

0UT1-P0=1 . 00000000*OUTO.PO 
ADD OUTO-PO, 0UT1_P0,R02 

0UT0_P0=1 . 000000O0»0UT0_P0+0 . 2 5000000*OUT 1_P0 
ADD OUTO-PO, 0UT1.P0,R04 

: OUTO-PO* 1 . 00 00 000*0UT0-P0+0 . 3 1 23 0000*OUT 1 _ PO 
ADD OUTO-PO, 0UT2_PO,R03 

; OUTO-PO* 1 . 00 00 000*0 UTO-PO+O .3 125 00 0*OUT1-P0+0. 125 00 00 00* OUT 2.P0 
ADD OUTO-PO, 0UT2_P0,R06 

0UT0_P0=1 . OQOO0000*0UTO_P0+O.3125O00O*OUTl_P0+O. 14 062 5000»OUT2-P0 
ADD OUTO-PO, 0UT2.P0, RIO 

0UT0_PQ«1 000 00 000*OUTO_PO+0 . 3 1 25 00 00* OUT 1_P0 +0 . 14 1 601562*0U T2.P0 
SUB OUTO-PO, OUT2_P0,R0O 

0UT0-P0=1 . 00000 000 *0UT0_P 0+0. 3 1 250000*OUT l-PO-0 . 85 83984 3 *0UT2_P0 
ADD OUTO-PO, IN0_P0,R00 

0UT0_P0«1 . 00000000 *OUT0_P 0+0 . 3 1 25 0000* OUT l-PO-0 . 85839843 *OUT 2 _P0+ 1 0000 0000* I HO-PO 
B1»0 81611074 B2=-0. 33301838 

IHST=4 
POLE 1 = -882.54235, 1999. 9998, TS 

BEST YET 
POLE 1 = -441 .27120, 999. 99993, TS 

BEST YET 

IHST=5 
POLE 1 = -882.54235, 1333. 33325, TS 
POLE 1 = -441 .27120,999.99993, TS 
POLE 1 = -882. 54235, 643. 44500, TS 
POLE 1 = -624.41516, 1999. 9998, TS 
POLE 1 = -740 .48474, 1999. 9998, TS 
POLE 1 = -526. 27990, 908. 74194, TS 
BEST YET 

IN->T=6 

POLE 1 = -882 .54235, 920. 21374, TS 

POLE 1 = -882 .54235,643 .44500, TS 

POLE 1 = -882. 54235, 792. 42419, TS 

POLE 1 = -624 .41516, 783. 65319, TS 

POLE 1 = -740. 48474, 590. 33453, TS 

POLE 1 = -526. 27990, 908. 74194, TS 

POLE 1 = -624 .41516, 986. 73602, TS 

3E5T YET 

POLE 1 = -709 .42401, 1999. 9998, TS 

POLE 1 = -709.42401, 1999. 9998, TS 

POLE 1 = -549.43231,881 .42303, TS 
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-8 82. 54 23 3, 9 78.83 82 7, TS 
-882 .54235, 792. 42419, TS 
-882. 54 23 5, 784. 39 03 8, TS 
-624 .41516,986.73602. TS 
-7 40.48474, 106 3. 7 6843, TS 



INST*? 
POLE 1 * 
POLE 1 = 
POLE 1 = 
POLE 1 » 
POLE 1 = 

BEST YET 
POLE 1 = -624 .41516,986 .73602, TS 
POLE 1 = -740 .48474,964 . 17120, TS 

BEST YET 

POLE 1 = -709.42401,649 .02075, TS 

709 .42401,649.02075, TS 

•549.43231,881 .42303, TS 

-651 .50946,958.45196, TS 

700 .02026, 1999. 9998, TS 

-7 01 .8 898 9, 1999. 999 8, TS 

■555 .35443,874 . 23944, TS 



-882.5 4 23 5,993.08 331, TS 
-882 .54 235, 783. 8522 3, TS 
-882. 5423 5, 7 84. 53 43 0,TS 
-624 .41516,998.29034, TS 
-7 40. 48474, 1014. 922 11, TS 

-740 .48474,964 . 17120, TS 
-740 .48474,958 .08459, TS 
-709 .42401, 1091 . 25781 , TS 
-709 .4240 1, 1091 .25781 , TS 
-651 .50946,958.45196, TS 
-709 .42401,996 .21044, TS 

-700. 02 02 6, 665. 5882 5, TS 
-701. 88 98 9, 662. 33 392, TS 
-555 .35443,874 . 23944, TS 
-653. 24188, 956. 59979, TS 
-699 .94952, 1999. 9998, TS 
-700.02026, 199 9. 9998, TS 
-556 .84350,872.42010, TS 



-882.54235, 1000. 13574, TS 
-882.54235, 784. 53314, TS 
-882. 54 23 5, 784. 53 37 5, TS 
-624 .41516,999 .72717, TS 
-740 .4847 4, 100 2. 4 24 56, TS 
-7 40. 48474, 9 57. 67 76 7, TS 
-7 40. 48474, 958. 19 34 8, TS 
-709 .42401, 996.21044, TS 
-7 09 .42401, 996.21044, TS 
-709 .42401,996 .21044, TS 
-709.4240 1, 990 .4243 7, TS 
-700.02026,904 .42840, TS 
-701. 8898 9, 902. 25109, TS 
-6 53. 24188, 956. 59979, TS 
-701 .8 898 9, 100 3. 7 44 81, TS 

-699 .94952,665.71081, TS 
- 7 00. 2 02 6, 665. 5882 5, TS 
-5 56. 84 35 0,8 72. 42010, TS 
-6 54 . 1096 8, 955 .66 998, TS 
-700 .02026, 1999.9998, TS 
-557.58941,871 .50683, TS 



POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


IHST=8 




POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


BEST ' 


YET 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


a 


POLE 1 


a 


POLE 1 


= 


BEST ' 


YET 


POLE 1 


= 


POLE 1 


= 


POLE 1 


t> 


POLE 1 


- 


POLE 1 


- 


POLE 1 


= 


POLE 1 


= 


IHST=9 




POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= • 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


PJLt 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


BEST ' 


YET 


POLE 1 


= 


POLE 1 


* 


POLE 1 


= 


POLE 1 


= 


POLE 1 


= 


POLE 1 


3 
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701 .88989. 1003.744 81 . TS 



IHST=9 
POLE 1 
BEST 
PERROR = 1 8898925. -3.7448120 



LDA OUT2_P1.OUT1_P1.ROO 

; 0UT2-P1-1 00000000*OUT1_P1 
LDA OUT1_P1.OUTO_P1.ROO 

0UT1_P1~1 00000000*OUTO_P1 
SUB 0UT0_P1.0UT1_P1.R03 

0UT0_P1=1 . 00000 000*OUTO_P 1-0 . 1 25000 000*QUT1 _P 1 
SOB 0UT0.P1 .QUT1.P1.R04 

: 0UT0_P1=1 . 00000000*0 UTO-P 1-0 . 1 8?500 00*OUT 1_P1 
SUB 0UT0_P1.0UT2_P1.R02 

; OUTO_P1=1.00000000*OUTO_P1-0.187SOOOO*QUT1_P1-0.25000000*OUT2_P 
SUB 0UT0_P1.0UT2_P1.R04 

0UT0_P1»1 . 00000000*OUTO_Pl-0. 1 8750000*OUT 1_P1 -0 . 31 250000*0UT2_P 
SUB 0UT0_P1.0UT2_P1.R06 

: QUTG_P1=1 . 00000000*OUTO_Pl-0. 1 8 7500 00*OUT 1_P1 -0 . 32 8 12500*0UT2_P 
SUB 0UT0_P1.0UT2_P1.R08 

0UT0_P1=1 00000000*OUTO_P 1-0.1 8750008*OUT1_P1-0. 33203 125*0UT2_P 
ADD 0UT0_P1.IH0_P1.R00 

0UT0_P1=1 00000000*OUTO_P 1-0.1 8750000*OUT1_ PI -0.33 2031 25*0UT2-P 
FILE DELETED 

PZ SAVED IH TEMPORARY FILE 
1 POLES/ZEROES REMOVED 
1 POLES/ZEROES REMOVED 
THIS MACRO HAS REMOVED ALL PZ. 

THE PZ ARE SAVED IH THE FILE TEHPXX.QQQ 
TO RESTORE ALL PZ FROM THAT STAGE. TYPE 



+1 .0000000 



IHC TEMPXX.TMP 



*e:<it 



Following is the contents of the file created by the CODF1L macro. 



;A.-D CONVERSION ROUTINE ADDED 8Y MACRO ADCONV 

IN2 

IN2 

IH2 

HOP 

HOP 

CVTS 

ADD 0AR,KH2.R00.CHD6 

HOP 

HOP 

CV' 1 

HOP * 

HOP 

CV?b 

HOP 

HOP 

CV'5 

HOP 

HO? 

CVT4 

HOP 

NOP 

CVT3 

HO? 

HO? 

CV2 

HO? 

HO? 

CV r : 

HO? 

NO? 

CV T 

HO? 

HO? 

LD* 

; E MD 



[NO-PO.DAR ;SCALE INPUT HERE 
OF MACRO ADCOHV 
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JSThRT of code generated bv macro codfil 



:^o. 


.PI 


EQU 


OUTO. 


.PO 


INO. 


_P2 


EQU 


OUTO. 


-PI 


I MO. 


.P3 


EQU 


OUTO. 


_P2 


Ir<0. 


_P4 


EQU 


OUTO. 


_P3 


ISO. 


.P5 


EQU 


OUTO. 


.P4 


!NO. 


.P6 


EQU 


OUTO. 


-P5 


IHQ. 


.?? 


EQU 


OUTO. 


.pe 


ItfO. 


.P8 


EQU 


OUTO. 


.P? 


I ;W . 


.P9 


EQU 


OUTO. 


.PS 



IHQ.PIO EQU 0UTQ.P9 

J'CODE FOR POLE 0.00000000 AT -100.000000.. 1000. 00000 
•> MO"E: HAKE SURE SIGNAL IS <0. 761-90478 
LDh 0UT2_PG,0UT1_P0,R00 

0UT2_PG=1 . 00000000*OUT1_PO 
HO* 3UTl_P0,0UT0_P0,R0G 

0L«T1_P0=1 . 00000000 *0U TO .PO 
ADC* -3UTG_P0,0UT1_P0,R02 

OUTO_PO=1 . 00000000*OUTO_P 0+0 .2 5000000* OUT 1_P0 
ADC' OUTG_P0,GUTl_P0,R04 

0UT0_P0=1 .000 00 00*0 U TO -P0+0 .3 125 00 00* OUT 1_P0 
ADD OUTO-PO, 0UT2_P0>R03 

0UT0_PG=1 . OOOO0OOO*0UTO_P0+0 . 3 1 25O00O*OUT 1_ PO + . 125000000*0UT2_P0 
ADO JUTO-PO, 0UT2_P0,R06 

OUTO. POM . 00 00 000*0 U TO .PO+0 .3 125 0000* OUT 1_ PO+0. 14G6250GG*GUT2_PQ 
ADC- 0UT0_PG,GUT2_P0,R1G 

0UT0_P0=1 .00000 000 *0U TO _PG+Q .3 125000 C*OUT l_PO + 0. 14 160 1562* OUT 2_P0 
Sue 0UT0_P0..0UT2_P0,R00 

0UT0_P0=1 . 00000000*OUTO_PO+0 . 3 1 250000*GUT l-PO-0 . 85839843*0UT2_P0 
ADD OUTO-PO. INO.POi ROO 

; OUTO. PG= 1 . 00000000 *0U TO _P 0+0 3 12500 00* OUT l.PO-0. 85839 843*0UT 2 _P0+1 .0000 0000* I NO_PO 
.: ABOVE CODE MOVED POLE 0.00000000 TO -97.203498 , 997.82714 

iCODE FOR POLE 1.00000000 AT -700 00000, 1000.00000 
LDA GUT2_P1,GUT1_P1,R00 

0UT2_P1=1 . 0000000Q*0UT1_P1 
LDh OUT1_P1,OUTO-P1 ,R00 

0UT1_P1=1 .00000000*OUTO_P1 
SU?. 0UT0_P1.0UT1_P1,R03 

OUTO_P1=1 . 00000 000 *OUTO_P 1-0 . 1 25000 000*OUT1 _P 1 
SOB GUT0_P1.. 0UT1.P1 ,R04 

OUTO_P1=1 00000 000 *0U TO _P 1-0 . 187500 00* OUT 1_P1 
SUB 0UT0-P1.. 0UT2.P1 ,R02 

0UT0_P1=1 . 00000 000*0UT0_P 1-0 . 18 75 00 00*0UT1_P1- 0.25 00000 0*0 UT2_P1 
SUB 0UT0-P1.. QUT2_P1,R04 

0UT0_P1=1 . 00000000*OUTO_P1-0.18 750000*OUT1-P1-0.31250000*OUT2_P1 
SUB 0UTQ_P1,0UT2_P1,RQ6 

0UT0_P1=1 00000 000 *0U TO _P 1-0 . 1 8 7500 00* OUT 1_P1 -0 . 328 12 500*0UT2_P 1 
SUB QUT0_P1,0UT2-P1 ,R08 

: 0UT0_P1=1 0000 000*00 TO _P 1-0 1 8 750000* OUT 1_P1 -0 . 33 203 125*0UT2_P 1 
ADD 0UT0-P1, IHO.Pl.ROO 

• 0UT0_P1«1 . 0000000*0(1 TO -P 1-0 . 1 8 7500 00* OUT 1_ PI -0. 33203 125*0UT2_P 1+ 1 . 000 0000* I NO_P 1 
.: ABOVE CODE HOVED POLE 1.00000000 TO -701.88989 . 1003.74481 

-BE SURE TO DO THE FOLLOWING SCALING FOR EACH STAGE 

J PLUS ANY OTHER SCALING COMMENTED IN THE GENERATED CODE 

;SH!FT RIGHT INPUT OF POLE i 1.00000000 BY 1.00000000 BITS 
JSHIFT RIGHT INPUT OF POLE t 0.00000000 BY 4 0000000 BITS 
;£ND OF CODE GENERATED BY MACRO CODFIL 
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CHAPTER 11 

ADVANCED TECHNIQUES: OTHER 

ROUTINES FOR SIGNAL PROCESSING 



Introduction 

The macros given as examples in this chapter go beyond filter design into more 
general routines such as multiplication and division of variables, input/output 
coding, and oscillators. They too are supplied in the file SPAC20.MAC. As 
mentioned in Chapter 10, the intention in supplying these macros (in addition to 
their immediate utility) includes their role as models for your own development of 
macros, routines pertinent to signal processing and other functions important to 
your 2920-based product development. As with all macros, particular attention must 
be paid to supplying correct parameters in the appropriate order, to avoid erroneous 
operation or output. 



♦DEFINE MACRO MULVAR 

This macro generates code for 

a four quadrant/ 9-bit multiplication of two variables. 

MULVAR U TF I LE, PRO DUCT, MULTIPLICAND, MULTIPLIER 



* i Ca 1 I i ng sequence 



EXAMPLE tttULVAR F.MUL,U,X,Y 

this will put in the file F.MUL the code to 
implement the equation U = X*Y 



HPPEND 


XO 










; BEGIN MACRO MULVAR 


« ** ** 


ttPPEND 


y.o 


SUB 


y.i 


xi , 


R00 


; 


CI 


ear 


th 


e product 


* 


APPEND 


xo 


LDA 


DAR 


X3, 


R00 


; 


Mu 


It )p 


I i 


e r to DAR 


* 


APPEND 


xo 


ADD 


y. i 


X2, 


R01 , 


CND7 




* 




This 


* 


APPEND 


XO 


ADD 


y. l 


XI, 


R02, 


CND6 




* 




is the 


* 


APPEND 


xo 


ADD 


y. t 


X2, 


RQ3, 


CND5 




* 




nu It i pi y 


* 


APPEND 


XO 


ADD 


y. i 


y.2 , 


R04, 


CND4 




* 




process , 


* 


hPPEND 


xo 


ADD 


y. i 


XI, 


R05, 


CND3 




* 




b i tu i se 


* 


APPEND 


y.o 


ADD 


*{ l 


X2, 


R06, 


CND2 




* 




add i ng and 


* 


HPPEND 


y.o 


ADD 


y. i 


y.2, 


R07, 


CND1 




* 




sh i f t i ng 


* 


hPPEND 


y.o 


ADD 




X2, 


R08, 


CNDO 




* 






* 


APPEND 


y.o 


SUB 


:<2 


X2> 


L01 






These 


two supply 


* 


APPEND 


y.o 


ADD 


y.i 


X2, 


R00, 


CNDS 




the 


correct s i gn 


* 


APPEND 


y.o 










; 1 


:nd 


MACRO 


MULVAR ******* 



This performs a 9-bit multiply. If more 
precision are required, the high order b 
nay be Masked off, and the renaining bit 
loaded to the DAR. The (tasking operation 
orevent overflow saturation. < See AS292 

The last two steps above can be elimina 
is known to be positive. The first step 
■. f the operation is to be of the form: 



b i ts of multiplier 
its of the nu 1 1 i p I ier 
s shifted left and 

is necessary to 
manual for more info 
ted if the nu It i p 1 ier 
must be el i n i nated 

Y .* U*X + Y 



*£M 
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♦DEFINE MACRO DIV 

This Macro generates code for a four quadrant division 
of 2 var i ab les 
Calling sequence :DIV FILE, DIVIDEND. D I VI DEND*SCALE . DIVISOR, QUOTIENT. 
EXAMPLE :DIV F . D IV , X , R02, Y , U 

this will put in the file F.DIV code to inplenent 
the equation V = C X * 2**-2 >/ <Y> 

BEGIN MACRO DIV *************' 

; These two extract the *' 

; nagn i tudes . * ' 

» This clears the DAR. *' 

This is •» ' 

the d i v ide, * ' 

progressing *' 

one bit * ' 

a t a t i n e . * ' 

jThis forces overflow <#> * ' 

; These tuo establish *' 

the correct sign. *' 

Xfer result to output. * ' 

END MACRO DIV ************** ' 

* : 

* , 

*: Note that the first two operations extract the Magnitudes for the 

* division. The DAR is cleared and the carry set by the third instruction. 

* .' After the division sequence, an overflow <#> will be forced by the 'ADD' 
* : instruction fourth fron the end, if the dividend exceeded the divisor 

* > note that SUB... CNDS behaves differently fron the other CND inst >. 

* >' The last three instructions serve to establish the sign of the result, 
*> and transfer the result to the output. As the division is carried only 
*. to nine bits, the sign correction routine is allowed to leave sone 

*: error in positions beyond the thirteenth. 
*£H 



APPEND 


SO ' 










i 


rtPPEND 


so 


' ABS 


DV1, 


SI, 


S2 




APPEND 


SO 


' ABS 


DV2, 


S3, 


R00 




ftPPEND 


so 


' SUB 


DAR, 


DAR. 


R0 




APPEND 


so 


' SUB 


t>Vl , 


DV2, 


R00, 


CNDS 


ttPPEND 


SO 


' SUB 


DV1. 


DV2, 


R01, 


CND7' 


APPEND 


so 


' SUB 


DVl, 


DV2, 


R02, 


CNDS 


ftPPEND 


so 


' SUB 


DV1, 


DV2, 


RG3, 


CNDS' 


APPEND 


so 


' SUB 


DVl. 


DV2, 


R04, 


CND4 


APPEND 


so 


' SUB 


DVl , 


DV2. 


R05, 


CND3' 


APPEND 


so 


' SUB 


DVl , 


DV2, 


R06, 


CND2 


ftPPEND 


so 


' SUB 


DVl. 


DV2, 


R07, 


CND1 ' 


ftPPEND 


so 


' SUB 


DVl, 


DV2. 


R06, 


CNDO 


APPEND 


so 


' ADD 


DAR, 


KP4, 


L01 




bPPENO 


so 


• ! IDA 


':<, 


S 1 , 


R13 




ftPPEND 


so 


' XOR 


S4, 


S3 , 


R13 




APPEND 


so 


' XOR 


S4, 


DAR 






ftPPEND 


so 


' 








; 



•DEFIN 
*;THI 

* WttR 

* CAL 
*:£XA 

* ' AHD 

* :OUT 

* • : SA 

* IF T 
*CRAP 
*£L-SE 
*CODE 
*UR!T 
**COD 

* *•' 
*APPE 

* APPE 
*«PPE 
*EN£> 
*EM 



E MACRO SAW 

S MACRO GENERATES A SAUTOOTH WAVEFORM 

NING: TS MUST BE ASSIGNED AN APPROPRIATE VALUE BEFORE CALLING THIS MACRO. 

LING SEQUENCE: :SAW CODEF ILEN AHE . EXT . FREQUENCY* HZ >, ERR0R(H2>, OUTPUTVAR 

MPLEs TO CODE A SAyTOOTH FOR 25? HERTZ ttlTH AH ERROR OF LESS THAN 0.5HZ 

SAVE THE RESULTING CODE MODULE IN A FILE NAMED SAU257.ALS WITH THE 
PUT VARIABLE NAMED SAUOSC , YOU ENTER: 
U SAU257.ALS. 257, 0.5, SAUOSC 
S s THEN 
H IMPULSE i FORCE "SAMPLE RATE UNDEFINED" ERROR EXIT 

S3 - <S1 * TS * 4 > * KH2 + S3 ERROR < S2 * TS * 4 J DECREMENT THE SAWTOOTH 
E ' 
IHG COMPLETED - HOU APPENDING TO FILE 



ND SO CODEJBY FREQ X SAMPLETIME 

ND SO 'LDA DAR, S3' ; 

ND SO 'ADD S3,KP2,L02,CNDS'MF RESULT<0, 



ADD 1 
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♦DEFINE MACRO ADCONV 

* ■ 

♦.rDCONV MACRO to append to a file the A/D conversion 

* rout i nes 

* WARNING The user should be aware that the correct A/0 conversion 

* ■ routine <the number of IN instructions. HOP'S )is dependent 

* on the external environment of the systen (clock rate. 

* input sanple and hold capacitor etc.) and this nacro should 

* be adjusted accordingly. 
+ 

♦■CALLING SE8UENCE : ADCONV F ILEN AME . I NPUT STATEMENT. INPUT-NAME 

* EX. sADCONV FILTER. FIL »IN0. STAGE1IN 

* this uill put in the file FILTER. FIL the code 

* to sanple input port O.do a 9 bit A/D conversion 

* and put the result in STAGE1IN 

* rtpp y.a 

* * H.'D CONVERSION ROUTINE ADDED BY MACRO ADCONV 



♦ 'HOP 

♦ «HOP 
**C tf TS 

**ttt-D DAR. KM2.RQ0.CND6 

♦ «NOP 

♦ ♦NOP •' 

♦ APP XQ 'CVT? 

♦ ♦NOP 

♦ ♦NOP 
♦♦CVT 6 

♦ «NOP 

♦ "NOP 
*«C^T5 

♦ ♦NOP 

♦ ♦NOP 

♦ *Cv*T4 

♦ ♦MOP 
*«NOP 
*«C»'T3 

♦ «N0P 

♦ ♦NOP 
*«C";'T2 

♦ «NOP 

♦ rNOP 
♦ «C^T 1 

♦ * H P 

♦ «HOP 
*«CVTO 

♦ «NOP 

♦ ♦NOP 

**LL'H S.2.DAR JSCALE INPUT HERE 
♦k END OF MACRO ADCONV 

♦ * • • 

♦ EM 
♦ ; 



♦DEFINE MACRO TRIANG 
♦THIS MACRO TRANSFORMS A SAWTOOTH INTO A TRIANGULAR WAVEFORM 
♦^CALLING SEQUENCE .TRIANG CQDEF RENAME . EXT. OUTPUTVAR. INPUTVAR 

♦ APPEND 5C0 'LDA *1.X2' 

♦ APPEND *0 'ADD %l.KH4'i SUBTRACT 1/2 

♦ APPEND %0 'ABS U.U.LOl'; TAKE ABSOLUTE VALUE t DOUBLE IT 
♦APPEND XQ 'ADD *1.KM4"J SUBTRACT i/2 

♦ EM 
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*D£FIN 
. * :■ T H I 
. * ; I NT 
. * :CAL 

. *appe 

. *APPE 
. *APP£ 
. *APPE 
. *APPE 
. *APPE 
. *£I1 



E MACRO SINFIT 

S MACRO TRANSFORMS A TRIANGULAR WAVEFORM OF AMPLITUDE 1/2 

A SINUSOIDAL WAVEFORM OF AMPLITUDE 1 

LING SEQUENCE :SINFIT CODEFILENAHE .EXT, OUTPUTVAR, INPUTVAR 



ND *0 

ND 5j0 

ND 5C0 

ND 5C0 

ND '40 

ND *0 



LDA X1,X2,L02 

SUB %1,*1,R02' 

SUB Xi , X 1 , ROl 

SUB *1,X2,R04' 

ADD U ,5<2, ROl 



ADD 5£l,k2 



THIS TRANSFORMATION USES 

A PIECEWISE LINEAR APPROXIMATION 

TO SIN<PI*INPUTVAR> 

WHICH IS IMPLEMENTED USING 

OVERFLOW SATURATION. THEREFORE 



LIMITING MUST NOT BE DISABLED 



*DEF 

*JT 

* c 

* : ; 
*;E 

* ;0 

* ; A 

* iS 



INE MAC 
HIS MAC 
ALLING 
•SIHOSC 
XAMPLE: 
F 245 H 
MD APPE 
INOSC M 

AW so,* 

RIANG '/. 
■NFIT '/. 



RO SINOS 
RO GENER 
SEQUENCE 
CODEFILE 
TO GENE 
ERTZ, PL 
ND THIS 
YCODE . AL 
1 ,*2,SAW 
0,TRIANG 
0,fc3,TRI 



ATES A SINUSOIDAL WAVEFORM AT A USER-SPECIFIED FREQUENCY 

NAME. EXT, FREQUENCYC H2 >, FRE QE RR R< HZ > , OU T PU T V ARM AME 

RATE CODE FOR A SINUSOIDAL OSCILLATOR WHICH HAS A FREQUENCY 

US OR MINUS AT HOST 0.1 HERTZ, WITH AN OUTPUT NAMED 0SC245 

CODE TO DISK FILE HVCODE.ALS, YOU ENTER! 

S, 245, 1, 0SC245 

TOOTH 

ULAR, SAWTOOTH 

ANGULAR 



The following are examples of invoking these macros. The invocation line calls the 
macro by "colon name", e.g., :MULVAR, followed by the actual parameters to 
replace the formals in the macro definition. The expansion of the macro then 
follows, with execution delayed until every command has been verified as 
conforming with the SPAC20 Compiler language. (It is possible for a valid macro to 
expand into invalid commands due to the substitution of'actuals for formals.) 

After this test is passed, execution of the macro proceeds from the first executable 
command to the last, with the results displayed at the console (and on this listing 
file). Thus the macro commands, with formals replaced, are seen twice. The first 
two macros below illustrate this, and enable you to see fully the substitutions 
performed. This double display has been suppressed in the later examples. 



*T-5=:/ 10000 

TS = . 99999980/ 10**4 



* : MULVAR 

Th is 



:F1 ! CHAP 11 OUT, PRODUCT, MULT I PL IC AND .MULT I PL IER 



a four 
Cii 1 1 i ng 



aero generates code for 
quadrant, 9-bit Multiplication of two variables, 
sequence iMULVAR OUTF ILE , PRODUCT , MUL T I PLI CAND, MUL TI PL I ER . 

EXAMPLE iMULVAR F.MUL,W,X,Y 

this will put in the file F.MUL the code, to 
implement the equation W = X*Y 



PEND 
PEND 
PEND 
PEND 
PEND 
PEND 
PEND 
PEND 
PEND 
PEND 
PEND 
PEND 
PEND 
PEND 

'his p 
'ec i s < 
iy be 
>aded 
■event 
' he 1 a 
know 
' the 



Fl ; 


Fl : 


Fl : 


Fl : 


Fl : 


Fl : 


Fl : 


Fl : 


Fl ! 


Fi : 


Fl : 


Fl ; 


Fl : 


Fl : 



CHAP11 
CHAP11 
CHAPll 
CHAP11 
CHAPll 
CHAPll 
CHAPll 
CHAPll 
CHAPll 
CHAPll 
CHAPll 
CHAP 1 1 
CHAP 11 
CHAPll 



OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 



J BEGIN MACRO MULVAR *****' 



SUB 
LDA 
ADD 
ADD 
ADD 
ADD 
ADC- 
ADD 
ADO 
ADD 
SUB 
ADD 



PRODUCT, PRODUCT, R00 
DAR, MULTIPLIER, ROO 

PRODUCT, MULTIPLICAND, 
MULTIPLICAND, 
MULTIPLICAND, 
MULTIPLICAND, 
MULTIPLICAND, 
MULTIPLICAND, 
MULTIPLICAND, 
MULTIPLICAND, 

MULTIPLICAND, MULTIPLICAND 

PRODUCT, MULTIPLICAND, 



; C 1 ear the product 
Multiplier to DAR 



* * 



PRODUCT, 
PRODUCT , 
PRODUCT, 
PRODUCT, 
PRODUCT , 
PRODUCT, 
PRODUCT, 



ROl , 


CND? 


R02, 


CND6 


R03, 


CND5 


R04, 


CND4 


R05, 


CND3 


RG6, 


CND2 


R07, 


CND1 


R08, 


CNDO 


ND, 


L01 


ROO, 


CNDS 



* This *' 

* i s the *' 

* multiply * ' 

* process , * ' 

* bitwise * ' 

* adding and * ' 

* shifting * ' 

* * ' 
J These two supply 

the correct sign. *' 



J END MACRO MULVAR *******' 



erforms a 9-bit multiply. If more bits of multiplier 
on are required, the high order bits of the multiplier 
masked off, and the remaining bits shifted left and 
to the DAR. The wasking operation is necessary to 

overflow saturation. ( See AS2920 manual for more info 
st two steps above can be eliminated if the multiplier 
n to be positive. The first step must be eliminated 
operation is to be of the form.' Y = W*X + Y 
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BEGIN MACRO MULVAR ***** 



SOB 


PRODUCT, 


PRO 


L u'H 


DAR, MULT IP LI 


ADD 


PRODUCT, 


MUL 


ADD 


PRODUCT, 


MUL 


ADO 


PRODUCT , 


MUL 


ftDD 


PRODUCT, 


MUL 


ADD 


PRODUCT, 


MUL 


HDD 


PRODUCT , 


MUL 


ADD 


PRODUCT, 


MUL 


ADD 


PRODUCT , 


MUL 


SJB 


MULTIPLICAND, 


ADD 


PRODUCT , 


MUL 



DUCT, R00 

ER, ROO 

TIPLICAHD, 

TIPLICAND, 

TIPLICAND, 

TIPLICAND, 

TIPLICAND, 

TIPLICAHD, 

TIPLICAND, 

TIPLICAND, 

MULTIPLICAND, 
TIPLICAHD, 



; Clear the product 
Multiplier to DAR 



ROl , 


CND7 


R02, 


CND6 


R03, 


CND5 


R04, 


CND4 


R05, 


CND3 


R06, 


CND2 


R07, 


CND1 


R08, 


CNDO 


ND, 


L01 


ROO, 


CNDS 



END MACRO MULVAR 



* This * 

* i s the * 

* Multiply * 

* process, * 

* bitwise * 

* add i ng and * 

* sh i f t i ng * 

* * 
; These two supply 

the correct sign. * 
******* 



* : DI V : Fl ; CHAP 11 . OUT, DIVIDE ND,R03,DIVID SO R,QUOTIENT 

This nacro generates code for a four quadrant division 
of 2 variables 
Calling sequence : D 1 V FILE, DIVIDEND, D I V I DE ND fSC AL E , DIVISOR, QUOTIENT. 
EXAMPLE :DIV F D IV , X , R02, Y , W 

this will put in the file F.DIV code to iwplenent 
the equation U = < X * 2**-2 )/ <Y> 



APPEN 
*PPEN 
APPEN 
«PPEN 

APPEN 
APPEN 
APPEN 
APPEN 
HPPEN 
APPEN 
APPEN 
APPEN 
APPEN 

mPPEN 
sPPEN 
APPEN 
APPEN 
APPEN 



Note 
d : v i s 
Af ter 
i nstr 
1 not 
The I 
and t 
to n i 



D s F 1 

D :F1 

D :F1 

D :F1 



sCHftPll.QUT ' i BEGIN MACRO DIV ************* ' 

:CHAP11.0UT ' ABS DV1, DIVIDEND, R03 J These two extract th< 

:CHAP11.0UT ' ABS DV2, DIVIDSOR, ROO i Magnitudes. 

tCHAPU.OUT ' SUB DAR, DAR, ROO i This clears the DAR. *' 



Fl 


Fl 


Fl 


Fl 


Fl 


Fl 


Fl 


Fl 


Fl 



CHAP11 
CHAP11 
CHAP11 
CHAP11 
CHAP 11 
CHAP11 
CHAPU 
CHAP11 
CHAP11 



OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 



CHAPU .OUT 
CHAP 11 OUT 
CHAPU .OUT 
CHAPU . OUT 
CHAP11 .OUT 



SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 

ADD 
LDA 
XOR 
XOR 



DV1. 
DV1. 
DV1. 
DV1. 
DV1. 
DV1. 
DV1. 
DV1. 
DV1. 



DV2, 
DV2, 
DV2, 
DV2, 
0V2, 
DV2, 
DV2, 
DV2, 
DV2, 



DAR, KP4, 
QUOTIENT, 
QUOTIENT, 
QUOTIENT, 



ROO. 
ROl , 
R02. 
R03. 
R04. 
R05. 
R06. 
R07. 
R08 

LOl 



CNDS 
CND7 
CND6 
CND5 
CND4 
CND3 
CND2 
CND1 
CNDO 



DIVIDEND, 
DIVIDSOR, 
DAR 



This is * ' ■ 

the d i v i de , * ' 

progress i ng * ' 

one b i t *' 

i tt t tine. * ' 

jThis forces overflow <#> *' 
R13 < These two establish 

R13 ,' the correct sign, 

i Xfer result fo output. *' 

END MACRO DIV ************** J 



that 
ion. 
the 

UC t i O 

e tha 
as t t 
ransf 
ne b i 
in p 



the first two operations extract the magnitudes for the 
The DAR is cleared and the carry set by the third instruction 
division sequence, an overflow <#> will be forced by the 'ADD' 
n fourth fron the end, if the dividend exceeded the divisor 
t SUB... CNDS behaves differently fron the other CND inst >. 
hree instructions servt to establish the sign of the result, 
er the result to the output. As the division is carried only 
ts , the sign correction routine is allowed to leave sone 
ositions beyond the thirteenth. 



*EM 

ABS 
ASS 
SOB 
SOB 
SUB 
SUB 
S'JS 
S.-JB 
SUB 
•SJB 
S'JS 
SUB 
ADD 
LDA 
XOR 
XOR 



DV1, D 

DV2, D 

DAR, DA 

DV 1 , DV 
DV1, 
DV1, 



DV1, 
DV1, 
DV 1 , 
DV1, 
DV1, 
DVi, 
DAR, 



QUOTIE 
QUOTIE 
QUOTIE 



IDEND, 

IDSOR, 

ROO 

ROO, 

ROl , 

R02, 

R03, 

R04, 

R05, 

R06, 

R07, 

R08, 

LOl 

, DIV 

DIV 

DAR 



R03 
ROO 

CNDS 
CHD7 
CND6 
CNDS 
CND4 
CND3 
CND2 
CND1 
CNDO 

IDEND, 
IDSOR, 



BEGIN MACRO DIV ************* 

; These two extract the * 
i nagn i tudes * 

; This c lears the DAR . * 
; Thi s i s * 

; the d i v i de , * 

,' progress ing * 

; one bit * 

; a t a t i ne . * 
;This forces overflow <#) * 
R13 ,' These two establish 

R13 ,' the correct s i gn . 

; >^fer result to output. * 
END MACRO DIV ************** 
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* ADCONV :F1 :CHAP11 .OUT, IN2.INPUT1ST 



*;ttDC0NV MACRO to append to a file the A/D conversion 

* routines 
* 

* UihRNING The user should be aware that the correct A/D conversion 

* routine (the nuwber of IN instructions. NOP's )is dependent 
* . on the external environment of the systen (clock rate. 

* input sanple and hold capacitor etc.) and this nacro should 
■»■ be adjusted accordingly. 



* CALLING SEQUENCE 



ADCONV FILENAME. INPUT STATEMENT. INPUT.NANE 
EX. :ADCONV FILTER. FIL ,INQ, STAGEHN 

this will put in the file FILTER. FIL the code 
to sawple input port O.do a 9 bit A/D conversion 
and put the result in STAGEHN 



■-*?? ■ Fi :CHAP11 . OUT 

*■* rf.'D CONVERSION ROUTINE ADC-ED BY NACRO ADCONV 

•* * : t<2 

* « I >A2 

**:nz 

* * H P 
**N0P 

* * C V T S 

**AfrD DAR.KM2.R00, CND6 

* *NuP 

* * H P ' 

**PP i Fl : CHAP 11 .OUT 'CVT 7 

* *NOP 
**HOP 
**CVT6 

* *NOP 

* * N P 

* « C V T 5 

* *N0P 

* ♦■■HOP 
**CVT4 
**NOP 
**NOP 
**Cv'T3 

* -«NOP 
**H0P 

* * C • .•' T 2 
**N0P 

* «NGP 

**cvti 

**NOP 

* *NOP 
**CVT0 

* * M P 

* *NuP 

**LDA INPUT1ST.DAR J SCALE INPUT HERE 
♦♦END OF MACRO ADCONV 

*EH 
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;a/d conversion routine added by macro adconv 

IN2 

IN2 

IN2 

NOP 

NOP 

CVTS 

ADO [>AR,KM2,R00,CND6 

NOP 

NOP 

CVT? 

NOP 

NOP 

C V T b 

NOP 

NOP 

CVT5 

NOP 

NOP 

CVT4 

NOP 

NOP 

CV73 

NOP 

NOP 

CVT2 

NOP 

NOP 

CVT1 

NOP 

NOP 

CVTO 

NOP 

NOP 

LDA INPUT1ST,DAR ;SCALE INPUT HERE 

.END OF MACRO ADCONV 



* ; 

*:5A« :F1 .CHAP11 . OU T , 25? , . 5, SAWOSC 

* THIS MACRO GENERATES A SAWTOOTH WAVEFORM 

♦WARNING: TS MUST BE ASSIGNED AN APPROPRIATE VALUE BEFORE CALLING THIS MACRO. 
♦^CALLING SEQUENCE: :SAW CODEF RENAME . EXT, FREfiUENCY< HZ >, ERROR(HZ), OUTPUTVAR 
*:EXAMPLE: TO CODE A SAWTOOTH FOR 25? HERTZ WITH AN ERROR OF LESS THAN 0.5HZ 
*:AHD SAVE THE RESULTING CODE NODULE IN A FILE NAMED SAW257.ALS WITH THE 

* OUTPUT VARIABLE NAMED SAWOSC , YOU ENTER: 

* :SAU SAW257.ALS, 25?, 0.5, SAWOSC 
*IF TS=0 THEN 

♦GRAPH IMPULSE ; FORCE "SAMPLE RATE UNDEFINED" ERROR EXIT 

♦ ELSE 

♦ code sawosc = <257 * ts * 4) * km2 +■ sawosc error < 0.5 * ts * 4;decrement the sawtooth 
•wpite ' 
♦♦coding completed - now appending to file 

»* ' 

♦APPEND :F1 : CHAP1 1 OUT CODE;BY FREQ X SAMPLETIME 

♦ APPEND :F1 :CHAP1 1 OUT 'LDA OAR; SAWOSC; 

♦ APPEND :F1 :CHAP11 OUT 'ADD S AWOSC , KP2, L02 , CNDS ' J I F RESULT<0, ADD 1 

♦ EHD 
*EH 
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ADD SAWQSC, KM2,R03 

SAU0SC=1 . 0000 GG*SAW0SC+0. 1 25 00 00 0*KM2 
SUB SAW0SC,KM2,R06 

■ SAU0SC=1 . 000000 00* SAYOSC+0. 1 09 3 75 00Q*KM2 
ADD SAU0SC,KM2,R10 

SAW0SC=1 . 0000000* SAW0SC+0 . 1 10351 562 *K (12 
ADD SAU0SC,KM2,R12 

; SAW0SC=1 . 00000 00* SAW OS C+0 . 1 10595 70 3*KM2 
SUB SAU0SC, KM2,R07 

; SAU0SC=1 00000000*SAWOSC*0 . 102783203*KM2 

CODING COMPLETED - NOW APPENDING TO FILE 
ADD SAUOSC, KM2,R03 

; SAW«SC=1 .O0OOO0OO*SAWGSC*0 . 1 25000000*KN2 
SUB SAUOSC, KM2,R06 

SAWQSC=1 .00000000*SAWOSC+0 . 1 09 3 7500 0*K M2 
AD^ SAUOSC, KM2,R10 

SAWOSC-1 00000000*SAWOSC+0 1 1 3 51 56 2*K 112 
&t>i) SAUOSC- KM2.RI2 

SAUOSC =1 . 00000000* SAUOSC+0. 1 10 59570 3*KM2 
SUB SAUOSC, KM2,R07 

: SAWOSC=l . 000000 0* SAW OS C+0 . 1 02 7 83 20 3 *K 112 
LDA DAR-SAWOSC 
ADD SAUOSC, KP2.L02, CNDS 



; TR'.AHG :F1 i CHAP 11 . OUT, OUT 1, INI 

*;THIS MACRO TRANSFORMS A SAWTOOTH INTO A TRIANGULAR WAVEFORM 

♦ CALLING SEQUENCE iTRIAHG CODEF IL EN AME EXT , OUTPUTVAR, INPUTVAR 

♦ APPEND :F1 iCHAPll .OUT 'LDA OUT 1 , IN 1 ' 

♦rtPPEND iFl iCHAPll .OUT ' ADD OUT 1 , KM4 ' i SUBTRACT 1/2 

♦ APPEND :F1 iCHAPll .OUT 'ABS OUT 1 , OUT 1 , LO 1 ' ; TAKE ABSOLUTE VALUE 8, DOUBLE IT 
♦rtPPEHD :F1 iCHAPll .OUT 'ADD 0UT1,KM4'; SUBTRACT 1/2 

*EM 

DA 0UT1, INI 

DD GUT1,KH4 

BS 0UT1,0UT1, L01 

Ol> 0UT1,KM4 



* : T 

* - I 

* ;C 
*AP 
*flP 
**P 

*rtP 
*HP 
*hP 
*EH 

ue 
ue 

UB 
DD 



HFIT :F1 iCHAPll .OUT, OUT, IN 

HIS MACRO TRANSFORMS A TRIANGULAR WAVEFORM OF AMPLITUDE 1/2 

NTO A SINUSOIDAL WAVEFORM OF AMPLITUDE 1 

ALLING SEQUENCE :SINFIT CODEF ILEN AME . EXT , OUTPUTVAR, INPUTVAR 



PEND 
PEND 
PEND 
PEND 
PEND 
PEND 



:F1 


sFl 


iFl 


iFl 


:F1 


:F1 



CHAP11 OUT 
CHAPU .OUT 
CHAP11 OUT 
CHAP11 .OUT 
CHAP11 OUT 
CHAP11 OUT 



OUT, IN, L02 
0UT,0UT,R02 
0UT,0UT,R0 1 
OUT, IN, R 04 
OUT, IN, R01 
OUT, IN 



LDA OUT, IN, L02' J 
SUB OUT -0UT,R02' 
SUB 0UT,0UT,R01' 
SUB OUT, IN,R04' J 
ADD OUT, 1N,R01 ' i 



THIS TRANSFORMATION USES 

A PIECEUISE LINEAR APPROXIMATION 

TO SIN(PI*INPUTVAR > 
WHICH IS IMPLEMENTED USING 
OVERFLOW SATURATION, THEREFORE 



ADD OUT, IN' J LIMITING MUST NOT BE DISABLED 
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>i NUSt 
THIS M 
CALLIN 
: SINOS 
E/.AMPL 
OF 245 
AND AP 
SINOSC 

saw iF 

>; THIS 

► ' tfARNI 
'.: CALLI 

► ; EXAHP 

► rtND S 
> ; OUTPU 
'.: :SAW 

► IF TS= 
* GRAPH 
*£LSE 

+ C0DE 

* WRITE 
**CODI 

* ■* •' 

* HP PEN 
*»PPEN 
+APPEN 
*END 

■EM 

TRI ANG 
"THIS 
►CALLI 
►APPEND 
APPEND 
■APPEND 
'APPEND 

: S I N F I T 
'. THIS 

► ; INTO 
■: CALLI 

► APPEND 
'APPEND 
"APPEND 
'APPEND 

► APPEND 

► APPEND 

► E!1 

:« 



iF 1 t CHAP 11 .OUT, 24 3.0 . 1 .. OSC 

ACRO GENERATES A SINUSOIDAL WAVEFORM AT A USER- SPECI F I ED FREQUENCY 

G SEQUENCE : 

C CODEFILENAME. EXT , FREQUENC Y< H2 ) , FRE QERR0R< H2 > , OU T PUTV ARN AME 

Et TO GENERATE CODE FOR A SINUSOIDAL OSCILLATOR UHICH HAS A FREQUENCY 

HERTZ, PLUS OR MINUS AT MOST 0.1 HERTZ, WITH AN OUTPUT NAMED 0SC245 
PEND THIS CODE TO DISK FILE MYCODE.ALS, YOU ENTER: 

MYCODE.ALS, 245, 0.1, 0SC245 
1 ;CHAP1 1 .OUT, 24 5,0 . 1 , SAWTOOTH 
MACRO GENERATES A SAWTOOTH WAVEFORM 

NG f TS MUST BE ASSIGNED AN APPROPRIATE VALUE BEFORE CALLING THIS MACRO. 
NG SEQUENCE: : SAW CODEF I LEN AME . EXT , FREQUENC Y( HZ ) , ERRORCHZ), OUTPUTVAR 
LE i TO CODE A SAWTOOTH FOR 257 HERTZ WITH AN ERROR OF LESS THAN 0.5HZ 
AVE THE RESULTING CODE MODULE IN A FILE NAMED SAW257.ALS WITH THE 
T VARIABLE NAMED SAWOSC , YOU ENTER: 
SAW257.ALS, 257, 0.5, SAWOSC 
THEN 

IMPULSE ; FORCE "SAMPLE RATE UNDEFINED" ERROR EXIT 

SAWTOOTH = <245 * TS * 4 ) * KM2 + SAWTOOTH ERROR < 0.1 * T S * 4;DECREMENT THE SAWTOOTH 
NG COMPLETED - NOW APPENDING TO FILE 



D :F1 iCHAP 
D :Fl:CHAP 
D :Fl:CHAP 



:F1 :CHAP1 
MACRO TRAN 
NG SEQUENC 
Fl :CHAP1 
Fl :CHAP1 
Fl : CHAP1 
Fl sCHAPl 

: Fl : CHAP1 
MACRO TRAN 
A SINUSOID 
NG SEQUENC 
CHAP1 
CHAP1 
CHAP1 
CHAP1 
CHAP1 
CHAP1 



11. OUT CODE,'BY FRE8 X SAMPLETIME 

U.OUT 'LDA DAR, SAWTOOTH' ; 

11. OUT 'ADD SAWTOOTH, KP2, L02,CNDS' J IF RESULT<0, ADD 1 



1 OUT, TRIANGULA R, SAWTOOTH 

SFORMS A SAWTOOTH INTO A TRIANGULAR WAVEFORM 

EiTRIANG CODEFILENAME. EXT, OUTPUTVAR, INPUTVAR 

l.OUT 'LDA TRIANGULAR, SAWTOOTH' 

l.OUT 'ADD TRIANGULAR, KM4' ; SUBTRACT 1/2 

l.OUT 'ABS TRIANGULAR, TRIANGULAR, L01 



Fl : 


Fl : 


Fl : 


Fl : 


Fl : 


Fl : 



TAKE ABSOLUTE VALUE fc DOUBLE IT 
l.OUT 'ADD TRIANGULAR, KM4' ; SUBTRACT 1/2 

1 OUT, OSC, TRIANGULAR 

SFORMS A TRIANGULAR WAVEFORM OF AMPLITUDE 1/2 

AL WAVEFORM OF AMPLITUDE 1 

EiSINFIT CODEFILENAME. EXT, OUTPUTVAR, INPUTVAR 

l.OUT 'LDA OSC, TRIANGULAR, L02' ; THIS TRANSFORMATION USES 

l.OUT 'SUB OSC, 0SCR02' J A PIECEWISE LINEAR APPROXIMATION 

l.OUT 'SUB OSC, 0SCR01' J TO S INC PI *I NPUTV AR > 

l.OUT 'SUB OSC, TRIANGULAR, R04' ; WHICH IS IMPLEMENTED USING 

l.OUT 'ADD OSC, TRIANGULAR, R01' ,' OVERFLOW SATURATION, THEREFORE 

l.OUT 'ADD OSC, TRIANGULAR'; LIMITING MUST NOT BE DISABLED. 
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ADD SAWTOOTH, KH2,R03 

S AW TOO TH=1 .00000000* SAW TO OTH+0 . 12 500 0000* KM 2 
ADC- SAWTOOTH, KN2,R08 

SAUT00TH=1 .00000000»SA«TOOTH+0 . 128906250* KM 2 
ADO SAWTOOTH, KH2,R12 

: SAWT00TH = 1 . 00 00 0000* SAW TO TH +0 . 12 91 50390* KM 2 
ADD SAWTOOTH, KN2,R13 

SAWT0 0TH=1 . 00 000000* SAWTOOTH+0 . 1 2 92 7 24 60* KM 2 
SUB SAWTOOTH, KH2,R05 

SAWT0 0TH=1 . 00 00000 0* SAWTOOTH +0 . 0980 224 60* KM 2 

CODING COMPLETED - NOW APPENDING TO FILE 
ADD SAWTOOTH, KI12,R03 

SAWT00TH=1 .00000000*SAWT00TH+Q . 1 25000000* KM2 
ADD SAWTOOTH, KM2,R08 

; SAWT00TH=1 . 00 00 0000* SAW TOOTH +0 . 12 89 062 50* KM 2 
ADD SAWTOOTH, KH2,R12 

: SAWT00TH=1 . 00 00 0000* SAW TOOTH +0 . 1 291 503 90* KM 2 
AD:> SAWTOOTH, KH2 , R13 

. SAWTOOTH = 1 . 00 000000* SAWTOOTH+0 . 1292 724 60* KM 2 
SUB SAWTOOTH, KN2,R05 

SAWTOOTH =1 . 00 00 0000* SAW TOOTH +0 . 09 80 2 24 60* KM 2 
LDA DAR, SAWTOOTH 
ADD SAWT00TH,KP2,L02,CNDS 
LDA TRIANGULAR, SAWTOOTH 
ADD TRIANGULAR, KM4 
ABS TRIANGULAR, TRIANGULAR, L01 
ADD TRIANGULAR, KM4 
LDA OSC, TRIANGULAR, L02 
SUB QSC0SCR02 
SUB 0SC0SCR01 
SUB OSC, TRIANGULAR, R04 
ADD OSC, TRIANGULAR, R01 
ADD OSC, TRIANGULAR 



* E X I 
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APPENDIX A 
HELP MESSAGES 



♦ HELP 

*** Help is available for the following itens. Type HELP followed 

**« by the iten nam. Do not type the angle brackets. (For nore 

*** infornation on the help connand, type HELP HELP.) 

Filters and Filter Responses! 

DEFINE,(FILTER*RESPONSE>,GREF,HOLD,HOVE.(POLE*ORsZER0*L0CATI0N>, 

<P0LES*QR*ZER0ES>, REMOVE 
Graphics: 

FSCALE, GRAPH, YSCALE 
Code Generat ion: 

B0UNDS,C0DE,(MA*C0NSTRAINT>,<PZ*C0NSTRAINT> 
F i le/D isplay/Conpound Conn ends : 

< COMPOUNDS OHM AN DS> .EVALUATE, EX IT, <F I L E*C OHM AMDS >, HELP , MACRO, 

<PATH*NAHE>, WRITE 
H i seel laneous '• 

< BOOLE AH*EXPR >, < CONST AH T>, < EXPR>, <FUNCTI0N>, < IDE HT IF IER>, 
. < I NTEGER*EXPR>,< NUMERIC $CONS TAN T>,( PRIM ARY>, <PZ*REF>, <SP AC* REF), 

CSTRINO, < SYMBOL >,< SYMBOL I C* REF > 



*** 
• *■» 



*H£LP * 

(BOOLEA 

<B0 

B 

<BO0LEA 

AND 

< BOO LEA 

or a pa 

[ HOT 

E 

( <B 

E 

<C0t1PAR 



H*EXP 
LEAN* 

00 lea 
Ex : 

N$OPE 

OR 
N*PRI 
rent h 

1 <EX 
x : 

OOLEA 
x : 
ISON> 



R> - A 
PRIMARY 
n pr i na 

C . I 
RATOR>: 

XOR 
MARY> - 
es ized 
PR> <C0 
SIN< . X+ 
N*EXPR> 
(< . I <> 

> = 



Boolean valued <TRUE or FALSE) expression: 
> £<BQOLEAN*OPERATOR> < BOOLE AH*PR IHAR Y > I* 
ries connected with logical operators. 
< 10) AND < . I > 5 ) 



Either a conparison 
Boolean expression: 
HPARISON) <EXPR> 
1/. X) > .5 

) 

0) OR ( . I<)1 )> 

> < > 



of two (arithmetic) expressions 



<BOUMDS> - Piecewise linear upper and lower bounds on the gain. 
Used during coding to constrain the gain of the coded filter. 
LBOUND/UBOUND 

Display the current lower or upper bound setting. 
Ex: LBO 

LBOUND/UBOUND » <EXPR> AT <EXPR> t, CI <EXPR> AT <EXPR>J* 

Each <EXPR> AT <EXPR> establishes a vertex of the piecewise 
linear bound. Two connas in a row indicate a don't care region. 
Ex: UBO » AT 10, AT 59, -20 AT 60, AT 61, AT 1000 

LBO = -1 AT 10, -1 AT 59, , -1 AT 61, -1 AT 1000 
The deviation of the gain fron these bounds is revealed by the 
<SPAC$REF>s MSQE, and MERROR, and the < FILTERtRESPONSE > GERROR. 
Ss* <FILTER*RESPONSE>, <GRAPH>, <PZ*CONSTRAI NT > , <SPAC*REF>. 

CODE - Connand to generate 2920 assembly code into code buffer or 
display current code buffer contents: 
CODE 

Displau current code buffer contents. 
CODE POLE/ZERO < INTEGER$EXPR > C <PZ*C0NSTR AI NT> 3 

Generate code for specified pole or zero subject to the specified 
constraints. The default constraint is PERR0R<0,0» INST<20 
(t.e nininize positional error in fewer than 20 instructions). 
Ex ■' CODE POLE 1 

CODE ZERO 3 MSQE<01, INST< 1 1 
CODE <1DENTIFIER> = <PRIMARY> * <IDENTIFIER> C+ < IDENT IF IER > ] 
t <HA*CONSTRAINT> 1 

Generate code for multiplication of one variable and a 
constant, leaving result in another (or sane) variable. 
If the third (IDENTIFIER) is present, it nust be si?!? as first; 
code generated adds the result of the Multiplication to the 
first variable. The default constraint is 
ERR0R< <PRIMARY>/2**16» INST<20. 
Ex: CODE Y => (1/3>*X + Y 

CODE IN0-P1 = 03*DAR INST<5 
COD XI = .965*X1 ERR0R<.002 



A-l 



HELP Messages SPAC20 Compiler 



< COMPOUNDfCOHNANDS) - Several compound conoands exist: 

IF <B0OLEAH*EXPR> E THEN ] < CR > CORIF < BOOLE AN«EXPR> CTHEN] 

<CR> J* CELSE <CR> J END 

Here indicates any nunber of connands (possibly compound). 

<CR> is carriage-return. 
Ex : IF NAGAIHM THEM 

WRITE 'SCALE BY ', L0G( NAGAIN >/L0G( 2) 
EHD 
Two other conpound connands allow looping: 

REPEAT <CR> C [ WHI LE/UNT IL < BOOLEANfEXPR) <CR>H* END 

The connands are repeated until the WHILE or UHTIL clause 

pernits termination or until the Escape key is pressed. 

COUHT <INTEGER*EXPR> [ C WH ILE/UHT IL <BOOLEAN* EXPR > <CR)1J* 

EHD 

As in REPEAT* but loop terminates after a specified nunber 
of passes. 

Ex: COUHT 20 

EVALUATE S IH( . N*T PI /360 > 
.H » H + l 
END 

<COHSTANT> - A keyword which has a fixed nuneric value. 
P! 3.1415927 

TPI Twice PI 

HPI Half of PI 

DEFINE - Command to define a pole or iiro, a symbol, or a macro: 
DEFINE POLE/ZERO < I NTEGER*EXPR> = <POLE*0R$ZER0$L0CAT I OH > 
Create a pole or zero at the specified location. 
Ex: DEFINE POLE = -200,0,TS 

DEFINE Z 1000 = 1.01»PI/1Q,Z 
DEFINE . <SYMB0L*NAHE> =• <EXPR> 

Add < S YNBOL*MAHE ) to end of symbol table and assign it a value. 
E* : DEFIHE LABEL =100 

DEFINE MACRO <MAC*HAHE> <CR> <CR> EH 

Define a macro to consist of > a sequence of connands. 

Fornal paraneters <C0< >.l, ..., X9 will be substituted when macro 
is invoked. <CR> is carriage-return. 
See HACRO, SYMBOL. 

EVALUATE - Command to evaluate an expression. The value is displayed 
in decimal scientific notation. 
EVALUATE <EXPR> 

Ex: EVAL ( L0G( MAGAIN)/LOG( 2 > > MASK 255 

EXIT - Command to exit the debugging session and return control to 
ISIS-I I . 
EXIT 

<EXPR> - A numeric value expressed as an algebraic sequence of 
operand<s> and operator(s). It has the following form: 

OPERAND) [<0PERAT0R> <0PERAND>1* 
(OPERAHD) : 

C<UNARY*0P>] <PRIMARY> 
<UHAf?Y*0P>: 

<PRII1ARY>: 

<NUMERIC*COHSTAHT> ( Ex : 1979, 0.1011B, 0.FFF5H, 3.14159D) 

3YMB0LIC*REF> <Ex: . HAXfAGAIH, . STAGE*2> 

<$PAC*REF) <Ex: TS, INST, MSQE > 

<C0NSTAHT> (Ex: PI, HPI, TPI) 

<FUNCTI0N> <<EXPR>) ( Ex s S I N( TP I*TS*60 > , GAIN(60>) 

<PZ»REF> (Ex: REAL<P0LE 1), ANGLE(Z 99>> 

<<EXPR)> (Ex: <L0G<AGAIN)/L0G( 2) ), (.FRED+14D)) 

<: <B00LEAH*EXPR>) (TRUE=1, FALSE=0; Ex: ( . X< 1 00 > ) 



<0PERAT0R>: 



HOD MASK 
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<F IlE$COMHANDS> - Several commands manipulate ISIS files or devices! 
LIST <PATH$NAHE> 

Send a copy of all console input and output to specified 
log file or device. To terminate copying, type LIST : C : . 
DISPLAY <PATH*NAHE> 

A comnand to display an ISIS file. The display can be 
interrupted with the Escape key. 
Ex ! DISPLAY :Fl:PZ.TMP 

PUT/APPEND <PATH$NA«E> t <F ILE f OBJ ECT > t . < F I LEsOB JECT > J* ] 

Write the specified objects to an ISIS file or device. PUT 
indicates the file should be deleted first if it already 
exists. APPEND indicates the objects should be appended to 
the end of the file which will be created if it does not 
yet exist. If no objects are specified, commands are output 
which when INCLUDED will recreate the current state. 
Ex : PUT :F1 .'P2.THP PZ 

APPEND sFl (FILTER SRC ", STAGE ', .1, CODE 
INCLUDE <PATHsNAME> 

Take commands from specified file. 
<FILE*OBJECT>: 

CODE PZ MACRO SYMBOLS BOUNDS <STRING> <EXPR> 

<F ILTER*RESPQNSE> - One of the following filter responses: 

GAIN Gain in decibels as a function of frequency in Hertz. 

AGAIN Absolute gain as a function of frequency in Hertz. 

PHASE Phase delay in radians as a function of frequency in Hertz. 

GROUP Group delay in seconds as a function of frequency in Hertz. 

GERROR Signed deviation of GAIN from the LBOUND and UBOUND 

in decibels as a function of frequency in Hertz. 
See <BOUNDS>. 

IMPULSE Impulse response as a function of tine in seconds. 

STEP Step response as a function of tine in seconds. 

Each < F ILTERsRESPONSE > can be used as a command to tabulate the values. 
Each can be graphed. Each except IMPULSE and STEP can be used as a 
function in an expression, e.g. AGAIN<60). 
Se* :function>, GRAPH, <PRIMARY>. 

FSCALE - A command to display or specify the frequency range of interest 
during calculation and graphing of filter responses'- 
FSCALE 

Display current frequency scale. 
FSCALE * <EXPR> , <EXPR> I, <EXPR>]* 

Break the horizontal range of the graph into a number of piecewise 
logarithmic segments. A nearly linear frequency scale can be 
created this way. At most 10 values are allowed. 
Ex: FSC ■ 10, 10000 (initial condition) 

FSCALE - 1000,1500,2000.2500.3000,3500 (nearly linear) 

(FUNCTION) - A keyword which invokes a predefined function of its 
argument when appearing in a <PRIMARY> or <EXPR>. 

SIN Sine f unct i on 

COS Cosine function 

TAN Tangent function 

ASIN Inverse sine function 

ACQS Inverse cosine function 

ATAN Inverse tangent function 

EXP Exponentiation of e (2. 7182817) 

LOG Natural logarithm (inverse of EXP) 

SQR Square root 

ABS Absolute value 

< FI LTERsRESPONSE > Any frequency dependent filter response can be 
invoked as a function: Ex: PHASE(60) 
See <EXPR>, <F ILTER*RESPONSE> , (PRIMARY>. 

GRAPH - A command to graph a filter response or bound: 
GRAPH 

Redisplay the previous graph. 
GRAPH <FILTER*RESP0NSE>/LB0UND/UB0UHD 

Graph the specified filter response or bound. 
Ex: . GRAPH GAIN 
0GRAPH <FILTER*RE3P0NSE>/LB0UND/UB0UND 

Graph the specified filter response or bound on top of 

the last curve graphed. Old curve is indicated with plus signs 

in di splay . 

Ex: 0GR LBOUND 
See <B0UNDS>, <F ILTERf RESPONSE) . 
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GREF - Set or display the reference frequency and decibel gain used 
in ci I cul at i ng gain: 
GREF 

Display current gain reference. 
GREF = <EXPR> AT <EXPR> 

Specify the gain to be a certain value at a certain frequency. 
Ex: GREF • ftl 440 (0 decibels at 440 Hz) 
Th* absolute gain (AGAIN) at the reference frequency must be nonzero. 

HELP - Command to display a summary of the syntax of a command 
or component of a connand. 
HELP 

Display a list of all items for which there is help. 
- It-ens appearing in this list without angle brackets are 
connand keywords. Itens with angle brackets are command 
components . 
HELP < IDENTIFIER> 

Display summary of specified item. (IDENTIFIER) nay contain 
dollar signs* but not angle brackets. 
Ex: HELP P OLE S»0R* ZE ROE S 
HELP * 

Display the sunnaries of all itens. 
The following notation is used in the help sunnaries: 
[A] neans A is optional. 

CA]* neans A is optional and nay be repeated any number of tines. 
A/B neans either A or B nay be used. 

<A> neans there is also a help sunnary for the connand 
component A . 

HOLD - Connand to turn on or off sample and hold conpensat i on > or to 
display the current state: 

HOLD 

Display hold on or off. 

HOLD OH 

Turn conpensation on. This should be used when examining the 
characteristics of entire 2920 filter i np 1 enen t at i on . 

HOLD OFF 

Turn conpensation off. This should be used when calculating 
scaling factors between filter stages or when using the SPAC20 
conpiler to design analog circuits. 

< I i>ENT I FI ER > - A sequence of one or more of the following characters: 

ABCDEFGHIJKLI1NOPQRSTUVUXYZ0 12345 678 90 ?_ 
Th* first character can not be a decinal digit and only the first 31 
characters are significant Dollar signs ore allowed but are ignored. 
Ex: SCALE*FACT0R ?TEMP*1 IN0-P12 

< IHTEGER*EXPR> - An expression <EXPR> with an integer value: 
Ex: PI - (PI HOD 1) 

15 .000 

<L0G(HAGAIN)/L0G(2 >> HASK 253 
See <EXPR>. 

<HA*C0HSTRAIHT> - In a CODE nul t i p 1 i cat i on connand. specifies the 
constraint guiding the code generation: 
ERROR < <EXPR> C, INST < (EXPR>1 

Generate fewer than a specified nunber of instructions which 
effect a multiplication by a constant which differs by less 
than a specified value fron the desired constant. 
The default INST constraint is INST<20. 
Ex: ERR0R<O001 

ERR0R<0, INSTO0 (nininize ERROR with 9 instructions) 

INST < <EXPR> ^ 

Generate fewer than a specified nunber of instructions which 
multiply by a constant differing by less than one part in 2**16. 
Ex: INST < 10 

After coding has been completed* the <SPAC*REF> ERROR gives the 
signed difference between the requested multiplier and the actual 
multiplier. See CODE. <SPAC*REF>. 
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MACRO - Macros an user-created , nantdi connand sequtncif . Parameters 
ar» substituted when macros are invoked. Macros are analagous to 
the ISIS SUBMIT fac i I i ty : 

MrtCRO £<MAC*NAHE> C. <M AC*NANE> ]* ] 

display all' or only the specified nacro definitions 
DIP MACRO 

Display nacro directory* i.e. the list of defined nacro nanes . 
REMOVE MACRO t<MAC*NAME) C, < MAC*N AME> ]* 1 

Renove all* or only the specified itacro definitions. 

DEFINE MACRO <HAC*NAME> <CR> < CR > EM 

Define a nacro to consist of , a sequence of connands. 

Formal parameters '40, >. 1 , ..., *9 will be substituted when nacro 
is invoked. <CR> is carriage-return. 
: <MAC*HAME> C (PARAMETER) C, [(PARAMETER)]]*] 
Invoke a nacro with specified paraneters. 
Ext :flOG POLE 1. .001 

(PARAMETER) - Any sequence of tokens not containing a conna or (CR>, 
or a quoted string (STRING) possibly containing a conna or <CR>. 
Ex: POLE .1+1 

'A,B,C 
(MftC*NANE> - Any < I DENTI FI ER> . 

MOVE - Command to nove the locations of existing poles and zeroes. 
MOVE <P0LES*0R*ZEROES> TO CONT I NUOUS/TS/Z 

Move some poles or zeroes to a different plane. Movenent fron * 
CONTINUOUS/TS to Z involves the natched-Z transforn, and in 
the other direction* the inverse natched-Z transforn. 
Ex : MOVE PZ TO TS (convert to sanpled filter) 

MOVE (P0LES*0R*ZER0ES> TO < POLE *0R*ZER0*L0C ATI ON > 

Redefine the position and possibly the plane of the specified 
pol es or zeroes . 

Ex: MOVE POLE 1 TO -20,1010 <sane plane) 

MOVE ZEROES TO 0,0, TS (new plane) 

MOVE (P0LES*0R*ZER0ES> BY <EXPR> , <EXPR> 

Change the coordinates of the specified poles or zeroes by the 
two expression values. 

Ex: MOVE P 10 BY .01,0 (change radius if Z-plane pole) 

MOVE POLES BY 0,10 (change frequency if S-plane pole) 

(NUMER1C*CGNSTANT) - A sequence of numeric characters (digits) 
op-, .i(,a:iu including a period ("."> followed by an optional suffix, to 
specify the constant's base. If no suffix is specified, then the 
constant is evaluated with default decinal suffix. Dollar 
signs nay be used to inprove readability, but are iqnored. 
Ex: 0. 1001*101 IB ( binary) 

999D ( deci nal > 

1FA9H ( hexadec inal ) 

1.5 ( default deci na I > 

(PATHNAME) - The none of an ISIS-II file or device: 
Ex: iFliHYPROG 

:F2:TEST.001 
:LP: 

( POLESOR*ZERO*L0CAT 10N> - The location of a pole or zero on one of the 
three planes: 

-EXPR) , <EXPR> I, C0NTINU0US/TS/Z 1 

Specifies coordinates in a plane. If C0HT1NUOUS (S-plane) or 
TS (sanpled S-plane), coordinates refer to real and inaginary 
conponents expressed in Hertz. If Z (sanpled Z-plane>, 
coordinates are polar, the first is the radius and the second 
is the angle in radians. If no plane is specified when 

defining a pole or zero, the default is CONTINUOUS. If no 
plane is specified when noving a pole or zero, the plane renains 
unchanged . 

Ex : -5, 60 (60 Hz ) 

-5, 60, TS (60 Hz sanpled) 

.99, TPI/5, Z (One fifth the sanple rate) 
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(PRIMARY) - A nuniric 


value. 


<NUHERIC*COHSTANT> 


<Ex 


(SYHBOLIC*REF> 


<Ex 


<SPAC*REF> 


<Ex 


<CONSTAHT> 


(Ex 


(FUNCTION) ((EXPR>> 


(Ex 


<PZ*REF> 


(Ex 


(<EXPR>> 


(Ex 
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(POLES* QR*2ER0ES> - ft specification of a range of poles, a range of 
zeroes, all poles, all zeroes* or all poles and zeroes: 
POLE ( INTEGER*EXPR> [THROUGH < I NTEG£R*EXPR> ] 

One or wore poles specified by integer labels. 
Ex: PO ? 

POLES 10 THRU 19 
POLE 

A 1 1 poles . 
2ER0 (INTEGER*EXPR> [THROUGH ( I NTEGER*EXPR> ] 

One or nore zeroes specified by integer labels. 
Ex: ZERO 32 

ZEROES 10 THRU 19 
ZERO 

A 11 zeroes . 
PZ 

All poles and all zeroes. 

It has the following forns: 

1979/ 0.1011B, 0.FFF5H, 3.14159D) 

HAX*AGAIN, STAGE*2> 
TS, INST, HSQE) 
PI, HP I, TPI) 
SIH(TPI«TS*60>, GAIH(*0>> 
REAKPOLE 1>, AHGLE(Z 99>> 
(L0G(AGAIN)/LOG(2)>, < .FRED* 140 >) 
( (BOOLEAH*EXPR>) <TRUE=1. FALSE-0) Ex: (X(100>) 

(P2*C0NSTRAINT> - In a COOE pole/zero connand, specifies the 
constraint guiding the code generation: 

PERROR < <EXPR> , <EXPR> t. IHST < <EXPR>] 

Generate fewer than a specified number of instructions 
which inplenent a pole or zero whose coordinates differ fron 
the original coordinates by less than the two specified values. 
The default IHST constraint is IHST < 20. 
Ex: PER < 5,10, IHST < 14 

PERROR < 0,0 (nininize positional error) 
MSQE < <EXPR> C, IHST ( <EXPR>1 

Generate code so that the nean squared deviation of the gain 
fron the gain bounds (i.e. MSQE > is less than a specified value. 
Ex: HSQE < .1 

HSQE<0, IHSTdO (nininize HSQE with 9 instructions) 
MERROR ( <EXPR> [, IHST < <EXPR>] 

Generate code so that the naxinun absolute deviation of the gain 
fron the gain bounds (i.e. HERROR) is less than a specified vdlue. 
Ex: KERROR < .1 

HER(0, IHSTOO (nininize HERROR) 
INST < (EXPR> 

Nininize positional error. Sane as PERR0R<0,0, IHST( <EXPR> . 
See <B0UH0S>, CODE, <SPAC*REF>. 

(P2*REF> - A reference to a coordinate of a pole or zero location, 
used as a (PRIMARY) in an expression (EXPR,): 
REAL ( POLE/ZERO ( I NTEGERf EXPR> ) 

X coordinate of specified pole or zero in Cartesian coordinates. 
Ex: REAL (POLE 3) 
IMAGINARY ( POLE/ZERO ( I NTEGER*EXPR> > 

Y coordinate of specified pole or zero in Cartesian coordinates. 
RADIUS ( POLE/ZERO < I HTEGERfEXPR) ) 

Radius of specified pole or zero in polar coordinates. 
ANGLE ( POLE/ZERO < IHTEGERfEXPR > > 

Angle in radians of specified pole or zero in polar coordinates. 
For a pole or zero in an S-plane the X and Y coordinates are the sane 
as the <POLE*OR*ZERO»LOCATIOH> and the radius and angle are the result 
of converting these to polar coord inates. For a pole or zero in the 
Z-plane the radius and angle are the sane as the <P0LE*0R*ZER0*L0C ATI ON > 
and the X and Y coordinates are the result of converting these to 
rectangular coordinates. 
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REMOVE - Connond to delete a pole or zero* a synbol/ or a nacro. 
REMOVE <POLES*OR*ZER0ES> 

Renove poles or zeroes specified by integer labels. 
Ex! REMOVE POLE I 

REM 2 .BL0CK41 THRU . BLOCK* 1+ 10 
REMOVE POLES 
REM P2 
REMOVE <SYMBQLIC*REF> C, < SYMBOLI C*REF > J* 

Renove one or More symbols fron the synbol table. 
Ex: REMOVE LABELX 

REMOVE SYMBOLS 

Renove all synbols fron the synbol table. 
REMOVE MACRO <HAC*NAME> i, < M AC*H AHE > ]* 
Renove one or nore nacro definitions. 
Ex : REMOVE MACRO CHEB 

REMOVE MACROS 

Renove all nacros. 
Se* MACRO, SYMBOL. 

<SPAC*REF> - A keyword reference to an SPAC20 systen variable. Each nay 
be displayed by sinply typing the keyword. Those which are not read 
only nay be changed by typing the keyword followed by "«" and an <EXPR>. 
Each nay be used as a <PRIMARY> in an expression <EXPR>. 

ERROR Signed error in nultiplier fron last code nu It ip I icat i on 

connand (read only). 
INST Hunber of instructions in code buffer generated by last 

code connand (read only). 
M AGAIN Maxinun absolute gain over frequencies in the 

frequency scale (read only). 
NERROR Maxinun absolute deviation of gain fron lower and upper 

bounds (see BOUNDS) (read only). 
MSQE Mean square deviation of gain fron lower and upper bounds 

( see BOUNDS) (read only > . 
TS Sanple tine in seconds (positive nonzero). 

:<?I2E CRT screen width. Also deternines frequency scale and tine 

■ss-ft-le widths < 12<=XSI2E<=79) . 
YSIZE CRT screen height ( 5< *YS IZE< =25 ) 

<STRIHG> - A quoted string of characters used in a WRITE/ PUT/ or 
APPEND connand/ or used as a nacro paraneter . 
Ex: 'HELLO' 

'POLE 1 ; ANYTHING' 'S ALLOWED IN A STRING' 

SYMBOL - Refers to a sunbol in the synbol table: 
<3YMB0LIC*REF> 

Display the value of a synbol. 
Ex: STAGE*1 

SUM 
SYMBOL 

Display the entire synbol table. 
DEFINE <SYMBOL*NAME> = <EXPR> 

Add < SYMBOLsHAHE > to end of synbol table and assign it a value. 
Ex : DEFINE FACTOR = . 13FH 

<SYMB0LIC*REF> = <EXPR> 

Change the value of a synbol. 
Ex: LABELX = 5 

FACTOR = .ONE/16 
REMOVE <SYMBOLIC»REF> C , (SYMBOL IC *REF> 1* 

Renove one or nore synbols fron the synbol table. 
Ex: REMOVE SAVEIT 

REMOVE SYMBOL 

Renove all synbols fron the synbol table. 
<SYMB0L*NAME> - An (IDENTIFIER). 

<S 'MBOL ICsREF> - A reference to a synbol in the synbol table. 
See SYMBOL for related connands . 
-:SYMBOL*NAME) 

Access synbol in table with specified synbol nane. 
Ex: .L00P*INDEX 

WRITE - A connand to display to the console (and list device) strings 
and/ or expression values. Most useful in conpound connands and nacros: 

WRITE <WRITE*0BJECT> [/ <WR1 TE*0B J ECT > ]* 

Ex: WRITE 'CODING POLE NUMBER'/ I, ' NOW 

<WRITE*0BJECT> : 

(STRING) <EXPR> 
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YSCALE - A conntnd to display or set the vertical graphics scale: 

V SCALE 

Display the current YSCALE setting. If the setting is AUTO/ 
the current nininun and naxinun are also displayed. 

YSCALE » AUTO 

Specify that the vertical scale is to adjust to fit the 
nininun and naxinun of the curve being graphed. 

YSCALE = <EXPR> , <EXPR> 

Specify a fixed vertical scale. 
Ex: YSCALE = -PI, PI 



♦ EXIT 
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APPENDIX B 

KEYWORDS: DEFINITIONS 

AND DEFAULTS 



Constants, Operators, Functions 



ABS Operator, used in expressions, gives absolute value of the argument 

appearing to its right, e.g., ABS (Y), ABS (X-Y) 

ACOs Function used in expressions, giving the arc cosine of the argument 

AND Operator, used in logical expressions, gives bitwise conjunction of 

the argument appearing to its right with the argument to its left; 
both must be boolean expressions or integer expressions 

ANGIe Function used with a Z-plane pole or zero argument; returns the 

angle of the object; e.g., ANG (POL 2) 

ASIn Function used in expressions, giving the arc sine of the argument 

ATAn Function used in expressions, giving the arc tangent of the 

argument 

COS Function used in arithmetic expressions, gives cosine of the 

argument appearing to its right 

EXP Function used in arithmetic expressions, gives powers of 

e (=2.718281) 

HPI Constant, value 3.1415926/2= 1.57079633 

IMAg Function used with a S-plane pole or zero argument; returns the 

imaginary part of the object; e.g., IMA (ZER 12) 

LOG Function used in arithmetic expressions, gives natural log to the 

base e (2.718728) 

MASk Operator, used in arithmetic expressions, gives bitwise conjunction 

of the argument appearing to its right with the argument to its left; 
unrestricted e.g. PI MASK O.FFFFH = .14159, PI MASK 2 = 2.00 

MOD Function used in arithmetic expressions, gives the remainder from 

dividing the argument to its left with the argument appearing to its 
right 

NOT Operator, used in logical expressions, gives the negation of the 

argument appearing to its right 

OR Operator, used in logical expressions, gives the inclusive or 

(disjunction) of the argument appearing to its right with the argu- 
ment to its left. Each must be a boolean or an integer expression 

PI Constant, value 3.141592653 

RADius Function used with a Z-plane pole or zero argument; returns the 

magnitude of the object; e.g., RAD (POL 217) 

REAI Function used with a S-plane pole or zero argument; returns the 

real part of the object; e.g., REAL (ZER 6) 

SIN Function used in arithmetic expressions, gives sine of the argument 

appearing to its right 

SQR Function used in arithmetic expressions, gives square root of the 

argument appearing to its right 

TAN Function used in arithmetic expressions, gives tangent of argument 

appearing to its right 
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TPI 
XOR 



Constant, value 3.14159265*2 = 6.2831852 

Operator used in logical expressions, gives exclusive or 
(disjunction) of the argument appearing to its right with the argu- 
ment to its left. Each must be a boolean or an integer expression 



Commands 

APPend File command, writes out the specified (or default) objects to the 

specified file, either creating a new file or adding to the end of an 
existing file (Chapter 7) 

CODe Creates AS2920 assembly language code for the current poles and 

zeros or for equations; also abbreviated C, CO 

COUnt Compound command, establishes maximum number of times 

command block is to be executed 

DEFine For symbols, creates an entry in a table and attaches a numeric 

value to it; 

for poles or zeros, the value is the coordinates and plane of that 
object; 

for macros, it is a pointer to the macro's block of commands 

DIR Used only in DIR MACRO command; lists all the names of 

macros currently available 

DISplay File command; copies the named file to the console 

EVAIuate Gives the decimal numeric value of the argument appearing to its 

right 

EXIt Terminates the current SPAC20 Compiler session 

GRAph Entered alone, this displays the last curve plotted; if a filter 

response is supplied as an object, e.g. GRAPH PHASE, this 
displays the graph of the values of the object specified, using the 
latest appropriate scales; also abbreviated GR 

If the object is LBO or UBO, the lower or upper bounds are 
graphed 

HELp Types explanatory message about the argument appearing to its 

right; if the item is *, types all such messages 

HOLd Command to correct attenuation due to sample-and-hold 

distortion: if ON, corrects AGAIN by multiplying by I sin(X)/X I, 
where X = TS*FREQ*PI, and corrects PHASE by adding X, and 
GROUP by subtracting PITS; also abbreviated H, HO 

IF Compound command, often used in macros, establishes 

conditional flow of control within a command block 

INCIude File command, executes contents of specified file as if typed as 

commands at the console , 

LISt File command, establishes file copy of all console interactions 

MOVe Command to change location or plane (or both) for one or more 

poles or zeros by specifying an increment or final value for each 
coordinate; also abbreviated M, MO 

OGRaph Displays the graph of the values for the filter response entered as its 

argument, simultaneously superimposing the last curve plotted; 
also abbreviated OG 

If the object is LBO or UBO, the lower or upper bounds are 
graphed 
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PUT File command, writes out the specified (or default) objects to the 

specified file, either creating a new file or writing over an existing 
file of the same name (Chapter 8) 

REMove Deletes from a table one, several, or all entries: poles, zeros, 

macros, symbols (Chapters 2, 3, 9) 

REPeat Compound command, establishes unlimited repetition of 

commands block (subject to optional WHILE or UNTIL clauses) 
(Chapter 9) 

WRIte File command, puts out one line to the LIST file and console; 

usually used in compound commands 



Objects 

AGAin Absolute gain, expressed as a multiplier, due to all existing poles 

and zeros; also used as a function with an expression (as its 
argument), giving the absolute gain at that (expression's) 
frequency; also abbreviated AG 

BOUnds Represents the piecewise linear bounds, in PUT or APPEND 

commands, or for display of LBO and UBO 

ERRor Absolute error in multiplier from last CODE command 

FSCale Frequency scale for computing and graphing filter responses, 

initially 10, 10000; establishes the range for the specific points (up 
to 69) of evaluation 

GAIn Gain in decibels due to all existing poles and zeros, normalized by 

the current setting of GREF; also used as a function with an 
expression (as its argument), giving the gain at that (expression's) 
frequency; also abbreviated G, GA 

GERror Deviation of the gain response from the bounds; also used as a 

function with an expression (as its argument), giving the gain error 
at that (expression's) frequency 

GREf Reference gain, expression AT expression, meaning a gain of 

expression 1 AT frequency expression2 

GROup Group delay of the filter (= the negative of derivative of the phase 

with respect to the frequency); also used as a function with an 
expression (as its argument), giving the group response at that 
(expression's) frequency 

IM Pulse Filter output in reaction to a unit up-impulse at time zero (i.e. an 

instantaneous jump from to 1 and return to zero) 

IN St Number of AS2920 assembly language instructions created by 

latest CODE command 

LBOund The lower of the bounds on gain, defined as piece-wise linear 

regions; intially -1000000 AT 1; also abbreviated LB 

MACro Entered alone, an object keyword to display all macro command 

blocks; when one or more macro names follow it, only the named 
macros command blocks are displayed; this word can also be a 
modifier keyword to qualify the effect of DEFINe or REMOVE, 
and it appears as a necessary part of the DIR MACRO command. 

MAGain Object keyword giving the maximum absolute gain taken over the 

frequencies in FSCALE 

MERror Maximum absolute error in gain relative to the bounds, considered 

over the frequencies in FSCALE 
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MSQe Mean square error in gain as compared to bounds, considered over 

the frequencies in FSCALE 

PERror Object keyword giving the allowable change in coordinates of the 

pole or zero to be CODEd; used only in CODE command, to 
specify a limit (constraint) on this movement, as in CODE POLE 
12 PERROR < 3,4 

PHAse Object keyword giving the phase delay response of the filter; also 

used as a function with an expression (as its argument), giving the 
phase delay response at that (expression's) frequency; also 
abbreviated PH 

POLe Used to display the pole whose number-label is the argument 

appearing to its right; also used as modifier to DEFINE or 
REMOVE to add or delete POLE entries (one, several, or all) in the 
table of poles and zeros; also abbreviated P, PO 

PZ Designates the entire set of poles and zeros, for display or as object 

to REMOVE, PUT, or APPEND 

STEp Filter output in reaction to a unit up-step at time zero (i.e. an 

instantaneous jump from to 1) 

SYMbol Designates entire set of numeric-valued user-symbols in that 

symbol table, for display or as modifier to REMOVE, PUT or 
APPEND 

TS Sample interval for sampled S-plane 

UBOund The upper of the bounds on gain, defined as piece-wise linear 

regions; initially 1000000 AT 1; also abbreviated UB 

XSIze Number of vertical columns defining entire graphics screen area, 

up to 79; i.e., maximum number of characters displayable per 
horizontal line; the area for curves being plotted is 10 less to allow 
for labeling the axis 

YSCale Specific range for vertical scale on graphs, by giving minimum and 

maximum values; if AUTO is specified, the min and max values of 
the curve being plotted are used 

YSIze Number of horizontal rows defining graphics screen area, up to 25; 

i.e., maximum number of characters displayable per vertical 
column is 25; the area for curves being plotted is 3 less to allow for 
labels 

ZERO Used to display the zero whose number-label is the argument 

appearing to its right; also used as modifier to DEFINE or 
REMOVE to add or delete ZERO entries (one, several, or all) in the 
table of poles and zeros; also abbreviated Z, ZE 



Modifiers 

AT Used in setting GREF, LBOUND, and UBOUND to specify 

frequencies, e.g. AT meaning DC, or AT 249 meaning Hertz 

AUTo Used in setting YSCALE, indicating full screen vertical scale for 

the actual range of the object being graphed 

BY In MOVE commands, tells the increments (in a coordinate pair) for 

the movement of one or more poles or zeros in the original plane of 
definition 

CONtinuous Designates continuous S-plane for pole or zero definition or 
movement 
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ELSe Identifies that block of commands (in an IF statement) which is to 

be executed if all earlier if-expressions proved FALSE 

EM Required end-statement for a macro definition 

END Required to end compound commands, i.e. REPEAT, COUNT, IF 

OFF Indicates there is to be no correction for sample-and-hold 

distortion; see HOLD 

ON Turns on correction for sample-and-hold distortion; see HOLD 

ORIf Identifies an alternate test expression and block of commands in an 

IF statement 

TH En Optional entry after the first test expression of an IF statement (and 

before the first block of commands) 

THRough Identifies the range of a partition, as in POLE 1 THROUGH 9 

TO In MOVE, tells the desired location of the object(s) being MOVEd, 

in(to) any plane 

UNTil A loop-exit in a compound command, causing execution to skip all 

commands between it and the next END statement when the 
expression after the UNTIL is TRUE. 

WHILe A loop-exit; when the expression following is FALSE, execution 

skips to the next END statement in the compound command 

Z Designates sampled Z-plane for pole or zero definition or 

movement 



List of all Keywords 



ABS 


ERROR 


MACRO 


REMOVE 


ACOS 


EVALUATE 


MAGAIN 


REPEAT 


AGAIN 


EXIT 


MASK 


SIN 


AND 


EXP 


MERROR 


SQR 


ANGLE 


FSCALE 


MOD 


STEP 


APPEND 


GAIN 


MOVE 


SYMBOL 


ASIN 


GERROR 


MSQE 


TAN 


AT 


GRAPH 


NOT 


THEN 


ATAN 


GREF 


OFF 


THROUGH 


AUTO 


GROUP 


OGRAPH 


TO 


BOUNDS 


HELP 


ON 


TPI 


BY 


HOLD 


OR 


TS 


CODE 


HPI 


ORIF 


UBOUND 


COS 


IF 


PERROR 


UNTIL 


COUNT 


IMAG 


PHASE 


WHILE 


DEFINE 


IMPULSE 


PI 


WRITE 


DIR 


INCLUDE 


POLE 


XOR 


DISPLAY 


INST 


PUT 


XSIZE 


ELSE 


LBOUND 


PZ 


YSCALE 


EM 


LIST 


RADIUS 


YSIZE 


END 


LOG 


REAL 


Z 
ZERO 
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While the following do not seriously affect the usability of the SPAC20 Compiler, 
they should be noted as areas for possible macro development by those users who 
find them inconvenient: 

There is no direct command for specifying an S-plane to Z-plane transform 
different from the matched-Z transform. Other transforms, if desired, must be 
implemented via macros. (See, for example, Chapter 10.) 

The SPAC20 Compiler produces IIR (infinite impulse response) digital filters. 
There is no facility to interactively design FIR (finite impulse response) filters. 

Step and impulse time responses are available but only over 64 or so equal time 
intervals, starting at zero. Ideally, the time response to a larger variety of inputs, 
over a larger variety of time scales, should be available. The computational 
complexity involved inhibits this for the present. 

In any digital filter implementation, anomalous behavior will occur when the 
input signal is small compared to the digital precision. Analysis of this dead 
band (i.e. region of signal amplitude causing misbehavior) and limit cycles (i.e. 
self-sustaining low amplitude oscillation) is in general difficult and is not 
undertaken in this product. 

Some calculations performed by the Compiler may press or exceed the limits of its 
floating point package. One such limit is the 24 bit precision of the numbers. If a 
pole and zero are superimposed, for example, the gain is almost, but not exactly, 
zero. Graphing this gain with YSCALE = AUTO can yield unexpected curves. 
Another limit is the 7 bit exponent. If many more poles than zeroes are defined, for 
example, underflow or overflow may occur and may distort the expected filter 
response. Alternately defining poles and then zeroes may ameliorate this problem. 

Because of the interactive nature of the SPAC20 Compiler, and because of the 
extensive floating point calculations, a high-speed math-board (iSBC-310) is highly 
recommended. 
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BNF SYNTAX SUMMARY 



This appendix summarizes the syntax for the SPAC20 Compiler using Backus Naur 
Form (BNF). The vertical bar means a choice among alternatives. Asterisk means 
the optional item (in square brackets) may be repeated any number of times. 

Command Summary 

<top-level comnd> ::= <define macro comnd> 

I <remove macro comnd> 
I <comnd> 

<comnd> ::=<compound comnd> | <simplecomnd> 

<compound comnd> ::= <if comnd> 

I <repeatcomnd> 

I <countcomnd> 
<simple comnd> ::= <display pole/zero comnd> 

I <define pole/zero comnd> 

I <move pole/zero comnd> 

I <remove pole/zero comnd> 

I <list filter response comnd> 

I <graph filter response comnd> 

| <display gref comnd> 

|<change gref comnd> 

I <display bounds comnd> 

I <set bounds comnd> 

I <display filter response function comnd> 

I <display scale comnd> 

I <set scale comnd> 

I <displaycodecomnd> 

I <codecomnd> 

I <displaycomnd> 

I <changecomnd> 

I <define symbol comnd> 

I <display symbols comnd> 

I <remove symbols comnd> 

1 < evaluate com nd> 

I <display filecomnd> 

I <putfilecomnd> 

I <append filecomnd> 

1 <includecomnd> 

I <listcomnd> 

I <writecomnd> 

I <helpcomnd> 

I <exitcomnd> 
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| <macro invocation comnd> 
| <display macro comnd> 
| <dir macro comnd> 

Expressions 

<exp> ::= <boolean term> [<or op> <boolean term>]* 

<orop>::=OR | XOR 

<boolean term> ::= <boolean factor> [AND <boolean factor>]* 

<boolean factor> ::= [NOT] <boolean primary> 

<boolean primary> ::= <arith exp> [<rel op> <arith exp>] 

<relop>::=< | > I <= I >= I = I <> 

<arith exp> ::= <arith term> [MASK <arith term>]* 

<arith term> ::= <term> [<plus op> <term>]* 

<plusop> ::= + | - 

<term> ::= <factor> [<mult op> <factor>]* 

<multop>::=* | / I MOD 

<factor> ::= [<plus op>] <secondary> 

<secondary> ::= <primary> [** <primary>] 

<primary> ::= (<exp>) 

I <function> (<exp>) 

| PI | TPI | HPI 

| <numericconstant> 

| <symbolicref> 

| <keyword reference> 

I <filter response function> 

I <pole/zero reference> 
<function>::=SIN | COS | EXP | LOG | SQR | ABS | TAN | ASIN | ACOS I ATAN 
<numeric constant> ::= <digit> [<digit>]* [<radix>] 

| [<digit>]* . <digit> [<digit>]* [<radix>] 
<digit>::=0 | 1 | 2 I 3 I 4 I 5 I 6 I 7 I 8 I 9 

|A|B|C|D|E|F 

<radix>::=B I D | H 

<symbolic ref> ::= <symbol> 

<symbol> ::= . <identifier> 

<partition> ::= <arith exp> [THROUGH <arith exp>] 

Keyword References 

<key word referenced :=TS | XSIZE | YSIZE | MAGAIN | MSQE | MERROR | INST 
I ERROR 

Filter Design Commands 

<display pole/zero comnd> ::= <poles and zeroes> 
<poles and zeroes> ::= <pole/zero> [<partition>] 

I PZ 
<pole/zero>::=POLE | ZERO 
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<define pole/zero comnd> ::= DEFINE <pole/zero> Orith exp> = <exp> , <exp> [, <plane>] 

<plane> = CONTINUOUS I TS | Z 

<move pole/zero comnd> ::= MOVE <poles and zeroes> <movement> 

<movement> ::= TO <exp> , <exp> [, <plane>] 

| TO<plane> 

I BY<exp>,<exp> 

<remove pole/zero comnd> ::= REMOVE <poles and zeroes> 

<pole/zero reference> ::= REAL ( <pole/zero> Orith exp> ) | IMAG ( <pole/zero> Orith 
exp>) I RADIUS (<pole/zero> Orith exp> ) | ANGLE (<pole/zero> Orith exp>) 

<list filter response comnd> ::= <filter response> 

<graph filter response comnd> ::= <graph/ograph> <filter response> 

| GRAPH 
<graph/ograph>::= GRAPH | OGRAPH 

<graph/ograph bounds comnd> ::= <graph/ograph> LBOUND | <graph/ograph> UBOUND 
<filter response> ::= GAIN 

| AGAIN 

| GERROR 

| PHASE 

| GROUP 

| STEP 

| IMPULSE 
<display gref command> ::= GREF 
<change gref command> ::= GREF = <exp> AT <exp> 
<display hold comnd> ::= HOLD 
<change hold comnd>::= HOLD ON | HOLD OFF 
<display bounds comnd>::= LBOUND | UBOUND | BOUNDS 
<set bounds comnd> ::= LBOUND = <piecewise linear bound> 

| UBOUND = <piecewise linear bound> 
<piecewise linear bound> ::= <bound> [, <piecewise linear bound>] 

| <bound> , , <piecewise linear bound> 
<bound> ::= <exp> AT <exp> 

<display filter response function comnd> ::= <filter response function> 
<filter response function> ::= GAIN ( <exp> ) 

| AGAIN (<exp>) 

| GERROR (<exp>) 

| PHASE (<exp>) 

| GROUP(<exp>) 
<display scale comnd> ::= FSCALE | YSCALE 
<set scale comnd> ::= FSCALE = <exp> , <exp> [, <exp>]* 

| YSCALE = <yscalesetting> 
<yscalesetting> ::=<exp> , <exp> | AUTO 
<display code comnd> ::= CODE 
<code comnd> ::= CODE <pole/zero> Orith exp> <pz constraint 

| CODE <multiplication><multiplication constraint 
<multiplication> ::= <y identified = <primary> * <x identifier> [ + <y identifier^ 
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<x identified ::= <identifier> 
<y identified ::= <identifier> 
<pzcontraint>::=[INST<<exp>] | MSQE<<exp> [, INST<<exp>] 

I MERROR<<exp>[, INST<<exp>] 

| PERROR < <exp>, <exp> [, INST < <exp>] 
<multiplication constraint> ::= [INST < <exp>] 

| ERROR <<exp>[, INST <<exp>] 

Interrogation and Utility Commands 

<display comnd> ::= <keyword reference> 

| <symbolic reference> 
<change comnd> ::= <keyword reference> = <exp> 

| <symbolic reference> = <exp> 
<define symbol comnd> ::= DEFINE <symbol> = <exp> 
<display symbols comnd> ::= SYMBOL 
<remove symbols comnd> ::= REMOVE <symbolic ref list> 

| REMOVE SYMBOL 
<symbolic ref list> ::= <symbolic ref> [, <symbolic ref>]* 
<evaluate comnd> ::= EVALUATE <exp> 
<display file comnd> ::= DISPLAY <path name> 
<put file comnd> ::= PUT <path name> [<file object>] [,<file object>]* 
<append file comnd> ::= APPEND <path name> [<file object>] [,<file object>]* 
<fileobject>::=PZ | BOUNDS | SYMBOLS | MACROS | CODE 

| <stringsand exps> 
<strings and exps> ::= <string or expression> [, <string or expression^* 
<string orexpression> ::=<string> | <exp> 
<include comnd> ::= INCLUDE <path name> 
<list comnd> ::= LIST <path name> 
<write comnd> ::= WRITE <strings and exps> 
<help comnd> ::= HELP [<help request>] 
<help request> ::= <help item> 

I * 
<help item> ::= <identifier> 
<exit comnd> ::= EXIT 

Compound Commands and Macros 

<if comnd> ::= IF <exp> [THEN] <cr> <true list> [ORIF <exp> <cr> <true list>]* [ELSE <cr> 
<falselist>]END 

<true list> ::= [<command> <cr>]* 

<false list> ::= [<command><cr>]* 

<cr> ::= carriage-return | line-feed 

<repeat comnd> ::= REPEAT <cr> <loop list> END 

<count comnd> ::= COUNT <exp> <cr> <loop list> END 

<loop list> ::= [<loop element> <cr>]* 
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<loopelement> ::=<command> f <loopexit> 

<loopexit>::= WHILE <exp> | UNTIL <exp> 

<define macro comnd> ::= DEFINE MACRO <macro name> <cr> <macro body> EM 

<macro name> ::= <identifier> 

<macro body> ::= [<command> <cr<]* 

<macro invocation comnd> ::= :: <macro name> [<actual parameter list>] 

<actual parameter list> ::= <actual parameter> [, <actual parameter>]* 

<actual parameter> ::=<limited token> * I <string> 

<limited token> ::= any token except <cr>, <string>, or "," 

<remove macro comnd> ::= REMOVE MACRO [<macro list>] 

<macro list> ::= <macro name> [, <macro name>]* 

<display macro comnd> ::= MACRO [<macro list>] 

<dir macro comnd> ::= DIR MACRO 
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Table of Sample Commands to Define, Display, or Remove Objects from 

Compiler Tables 





Defining an Object into a Table 


Displaying Part or 


Removing an Object from a Table 


One Symbol 




All of a Table 




DEFINE .NAME_1 =3 


.NAME_1 


REMOVE .NAME_1 




DEFINE .NAME_2 = .NAME_1 +1 


.NAME_2 


REMOVE .NAME_2 




DEF .NAME_3-.NAME_1*.NAME_2 






One pole 


DEF POLE 2 = -5, 450, TS 


POLE 2 


REMOVE POLE 2 


or zeros 


DEFZER0 2 = 1/2, 100, Z 


ZERO 2 


REM ZERO 2 


One Macro 


DEFINE MACRO JP 
xoxoxoxox 

xoxox 
EM 


MACRO JP 


REM MACRO JP 


Several Symbols 


Requires multiple commands 


Requires multiple 
commands 


REM ,NAME_1,.NAME ..2, .NAME_3 


Several poles 


Requires multiple commands 


POLE 1 THROUGH 5 


REM POLE 1 THROUGH 3 


or zeros 








Several Macros 


Requires multiple commands 


MACROS JP, RQ, TEN 


REM MAC RQ, TEN, FEEDER 


ALL Symbols 





SYMBOLS 


REMOVE SYMBOLS 


ALL poles 





POL 


REM P 


ALL zeros 





ZER 


REMZ 


ALL poles 





PZ 


REMOVE PZ 


and zeros 








All Macro Names 





DIR MACROS 





ALL Macros 





MACROS 


REMOVE MACROS 
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»• 

»- 

► 

»- 

>■ 

1 *- 

*- 

► 

*> 



c 



HELP command 



> 



c 



DEFINE or REMOVE 
symbols, poles, or zeros 



> 



C 



change or set commands 



> 



c 
c 



MOVE command 



> 



display commands 



> 



GRAPH commands 



> 



file commands 



> 



CODE command 



> 



IF and loop control commands 



> 



c 



MACRO commands 



> 



c 



EXIT command 



> 



*3 



chapter where discussed 

Commands 



121533-01 



•+-Q HELP ^ *- 



(36 help items are 

displayed when HELP 

is entered; see Appendix A) 



c 



-f help item J- 



Q> 



HELP Command 



121533-27 
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Syntax Charts 



Gh 



s 



( system constant I ► 



(unsigned A 
decimal 1 ► 
constant J 

(unsigned ~\ 
hexadecimal I » 
constant J 



(unsigned A 
binary 1 ► 

constant J 



Numeric Constant 



*CDn 

System Constant 



C 



digit 



P. 



K}rCE>r^^ 



Unsigned Decimal Constant 



f hex-digit J ' — r- 



o 
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-Q XSIZE J » 
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Q MAGAIN J- 



•Q MSQE y~ 
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-►f ERROR 



Keyword References 



-f • l ►( identifier }- 
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EXPonentiation and LOGarithms 
to the base e = 2.718281 
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~Q IMAG J- 



-**f ANGLE \- 



-f RADIUS \- 
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'(integer expression) *-f ) V-*- 
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An integer-expression is an arithmetic-expression which 
evaluates to an integer. 



Arithmetic Expression 
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numeric constant 



symbolic reference 



keyword reference 



> 



> 



function (expression) 
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filter response (expression) 
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(expression) 
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*-[ coordinate (pole/zero-expression) 
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chapter where discussed 
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■(pGRAPH IJ 



■c 



-^TboundV^ 

-(uBOUND )-»- 



-f freq-resp J->- 
-( time-resp J—*- 



GRAPH/OGRAPH 



-*~C PUT }-► 



-(dISPLAY~V»* 



- ( list > ^ 



-( INCLUDE J-»> 



-(pathname J- 



- (append "V»J 



I 

(-♦-(pathname J- 



c 



WRITE 



CE3* 



-(bounds')-*- 
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SYMBOLS 
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-( CODE J-*- 



-(macros J-»- , f 



o 



"*Lr; 



string 



> 



(expression\->- 



File Commands 
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CODE Command 
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SOFTWARE INSTALLATION 

PROCEDURE 



Software Installation Procedure 

The two modules of system software that support interactive development of signal 
processing programs for the Intel 2920 chip are the Intel Systems Implementation 
Supervisor (ISIS-II) and the SPAC20 software module. If the iSBC 310 math board 
is to be used, it should be installed as if to run FORTAN. (See the manuals listed in 
the Preface.) 

SPAC20 Compiler Files 

The SPAC20 Compiler consists of ten files, SPAC20.SFT, SPAC20.HRD, 
SPAC20.OVH, SPAC20.OV0 through SPAC20.OV5, and SPAC20.OVE. The first 
two represent different versions of the Compiler: SPAC20.HRD provides faster 
computations by taking advantage of the iSBC-310 math board, which must be 
present if this version is used. SPAC20.SFT performs the math functions in soft- 
ware. One of these two files should be renamed to SPAC20, using ISIS-II, e.g. 

RENAME :Fl:SPAC20.SFTto:F1:SPAC20 

The file SPAC20.OVH contains the help messages, which allows the Compiler to 
interactively give information about individual command syntax and options 
interactively, complementing the data in this manual. The help messages are 
described below and are reproduced in full in Appendix A. This file should be 
accessed only by the Compiler. 

The file SPAC20.OVE contains the error messages. SPAC20.OV0 through 
SPAC20.OV5 are overlays called by SPAC20 (SFT or HRD). There is also a macro 
file on the disk, SPAC20.MAC, containing the example macros shown in Chapters 
10 and 1 1 . If you wish to copy all the files to a backup diskette, you can use the term 
SPAC20.* (see ISIS manual). Specific macros can be edited into separate files for 
later INCLUDE commands. 

The Compiler can be invoked by typing the drive and file name after the ISIS 
prompt. For example: 

-: F1 :SPAC20 

The Compiler will sign on with the message: 

ISIS-II 2920 Signal ProcessingAppli cations C omp i L e r , V 1 .0 



You enter your commands to the Compiler one per line, and terminate each with a 
carriage-return. You may include comments by preceding them with a semicolon. 
Commands may be continued by typing an ampersand prior to both the carriage- 
return and the comment field (if any) of the line to be continued. Characters 
between the ampersand and the line terminator (carriage-return or line-feed) are 
ignored, and the ampersand is treated as a space. Each input line may contain no 
more than 120 characters before the line terminator. 

The ESCape key cancels the current activity and returns control of the Compiler to 
you. This applies to partially typed commands or commands in progress, including a 
macro or compound command. 
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All command keywords can be abbreviated to their first three characters, e.g., APP 
for append, or DEF for define. Many frequently used command keywords have 
single character abbreviations, such as P for pole, or Z for zero. Appendix B shows 
all keywords and their legal abbreviations. 

The EXIT command returns control to ISIS, ending the present use of the SPAC20 
module: 

*EXIT 



ISIS-II and SPAC20 Diskette 

The Intellec system uses the diskette hardware and ISIS to provide a powerful, 
convenient microcomputer development tool. ISIS interfaces to the diskette hard- 
ware and to any other standard peripheral device. You communicate with ISIS-II by 
entering commands on the system console or by embedding system calls in programs 
that will run in an ISIS environment. ISIS enables rapid storage and retrieval of files 
on diskette. 

Diskette files containing SPAC20 parameters or 2920 assembly language source 
code can be read or written during a SPAC20 design session. The main purpose of 
ISIS during setup and interactive development is to provide the I/O interface to the 
console and files on diskette. To begin a SPAC20 session, you must first boot ISIS 
and then load the SPAC20 software module. The process for booting ISIS is fully 
described in the ISIS-II System User's Guide and summarized below. 



Loading ISIS and the SPAC20 Software Module 

After installing all hardware and turning on power to the console, disk drives, and 
Intellec Series I, the following steps will load ISIS and SPAC20 (the full procedure 
and notes are in Chapter 2 of the ISIS-II User's Guide : 

a. Place system diskette in drive and close drive door. 

b. Press top half of boot switch on Intellec front panel. 

c. Press top half of reset switch on that panel. 

d. After interrupt light 2 goes on, press space bar. 

e. After the light goes off, press bottom half of boot switch. 

f . After receiving the ISIS sign-on message and prompt 

—ISIS-II Vn.n 
you type: 

— SPAC20 

If the diskette containing the SPAC20 module is not a system diskette, mount it 
in drive 1 instead of drive and boot ISIS from a separate system diskette in 
drive 0. Then, at this point, type :F1:SPAC20 (to load the SPAC20 module 
from drive 1) followed by a carriage return. The SPAC20 module will sign on 
and you are ready to continue. 

If ISIS fails to sign on, recheck that all boards and cables are correctly installed and 
firmly seated, then perform the above procedure again. 
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If you have an Intellec Series II, there are slight variations in the above procedure. 
This is what you must do: 

a. Turn on power to Intellec Series II and to disk drives. Press square white on/off 
button in the lower right-hand corner of front panel. It is a two-position switch; 
it lights up if you have pressed it correctly. 

b. Note that this message appears: 

SERIES II , MONITOR, Vn.n 

c. Place system diskette in drive and close door. 

d. Press reset button that is to left of the on/off button. Note that drive light is on 
to indicate that information is being accessed. 

e. After receiving the ISIS sign-on message and prompt 

— ISIS-II Vn.n 

you type: 

— SPAC20 

If the diskette containing the SPAC20 module is not a system diskette, mount it 
in drive 1 instead of drive and boot ISIS from a separate system diskette in 
drive 0. Then, at this point, type :F1:SPAC20 (to load the SPAC20 module 
from drive 1) followed by a carriage return. The SPAC20 module will sign on 
and you are ready to continue. 

If ISIS fails to sign on, recheck that all boards and cables are correctly installed 
and firmly seated, then perform the above procedure again. 
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Since the Assembler uses the ISIS-II keyboard and file capabilities, ISIS-II must be 
loaded before invoking the Assembler. The full procedure for this is given in the 
ISIS manual named in the Preface. Once ISIS-II is present, you can enter the Editor 
to key-in or modify the source text of your Assembler program. 

You need to finish five tasks before invoking the assembler: 

1. create the front-end analog-to-digital signal acquisition code, using the Editor. 
For this you need to learn the commands and rules for editing and file 
manipulation under ISIS-II, and the analog instructions of the AS2920 
Assembler. 

2. scale the signals entering each stage of the filter. For this you need to have a 
fairly clear idea of the expected original input signal, and to understand the 
techniques and warnings in Appendix J on scaling. Again you use the Editor (or 
APPEND commands) judiciously to create the required code (usually simply 
right shifts of already coded instructions) to precede successive stages. 

3. create the digital-to-analog code to output the results of the filter's 
manipulations, again via the Editor and appropriate Assembler commands. 

4. review the code files you now have. You may see an opportunity to combine 
analog instructions with arithmetic operations, as described in the Assembler 
manual. 

5. create a single program file for submission to the assembler, by copying each 
existing file in order to the new master. If there were nine such code files, this 
step might use two ISIS-II COPY commands to effect its purpose: 

COPY A_T0_D. INP, SCALED. ST1, STAGE2.SCA, ST3SCA.LED, & 
STAGE4.C0D TO TEMP 

COPYTEMP, ST5.C0D, ST6 . S C A , STAGE7 , D_T0_A . OUT TO MASTER 

(see ISIS-II manual for complete discussion of the COPY command.) 

After developing and editing the program into a form ready to test, you can invoke 
the Assembler as described below. 

The AS2920 Assembler may reside on the ISIS-II system diskette or on a non-system 
diskette. You load the assembler by entering a command that names the Assembler 
and specifies the source file. You may also name the list and object files, but you 
don't have to. Control options may also be specified as part of the command. 

After the assembler goes into execution, all assembler operations specified are 
performed without further intervention. If the invocation line has an error, the error 
is reported and you must retype the commands. You may use upper or lower case 
indiscriminately. The assembler converts all to upper case for its own use, except for 
echoing back what you typed exactly as it was. 

Example: 

-AS2920 FILTER. COD 

(After an ISIS-II prompt, shown here as a dash, you type the command as shown to 
assemble your source program, which is here assumed to be in the file named 
FILTER. COD. Assembly listing and object code files will be output to 
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FILTER. LST and FILTER. HEX, respectively. In addition, a symbol table listing 
will be suppled, and the symbol table debugging output to the object file is sup- 
pressed. These defaults are automatic when you do not specify any controls. It is 
exactly as if you had typed (on one line only) 

-AS2920 FI LTER . COD PRINT (FILTER. LST) LIST OBJECT (FILTER. HEX) SYMBOLS 
NODEBUG PAGING PAGEWI DTH (1 20) PAGE LENGTH (66) 

All but the last two options have opposites beginning with NO, like NODEBUG, 
whose opposite (however) is DEBUG. So you can say NOPRINT, NOLIST, 
NOOBJECT, NOSYMBOLS, or NOPAGING. 

All options are discussed in the AS2920 Assembler manual. Briefly, options 
beginning with NO suppress the indicated action. PRINT establishes a file for the 
listing of your program. LIST creates that listing. OBJECT creates the 2920 
machine code for your program and stores it in a file. SYMBOLS lists the names you 
used and their established RAM locations. DEBUG puts the symbol table out to the 
object file for your use in debugging via the Simulator. The page-related options 
specify how you'd like to see the listing output. Pages of 66 lines of 120 characters 
are the default format. 

After running the one assembler pass and completing assembly listing and object 
output, the assembler outputs a sign-off message and summary: 

ASSEMBLY COMPLETE 
ERRORS =XXXX 
WARNINGS =XXXX 
RAMSIZE =XXXX 
ROMSIZE =XXXX 
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Review of Continuous Analog Filters 

Analog filters have been in use for many years for a variety of signal conditioning 
and modifying operations. Originally, most filters were realized with resistors, 
inductors, and capacitors. More recently active circuit techniques have allowed 
elimination of most inductors, which tend to be large and may have linearity and 
coupling problems. Digital filters, such as realized with the 2920, have 
characteristics which resemble their analog counterparts. As a result a review of 
analog filter design and analysis may be of assistance to the reader. 

Complex networks of R-L-C (resistor-inductor-capacitor) elements are usually 
analyzed using complex variable techniques. A complex variable S is used to 
describe frequency, with a pure sinusoidal waveform of frequency f corresponding 
to 

s = j*2*Ti*f, where j = s f-^~ 

Each of the elementary RLC components has a voltage-current relationship which 
can be described by a simple equation: 

v = Ri ; for a resistorof resistance R 

v = sLi ; for an inductor of inductance L 

v = ( 1 / s C ) i ; foracapacitorofcapacitanceC 

The complex network is analyzed by using these relationships and the fact that the 
sum of all currents into a node must be zero, and the sum of voltages around any 
loop must add to zero. A set of equations is derived from the network topology, and 
solved to relate output voltage to input voltage, or some other relationship of 
interest. When such equations are solved for networks with finite numbers of 
elements, the result will take the form of the ratio of two polynomials in complex 
frequency s: 

v out Z(s) (s-z.,) (s-z 2 ) (s-z 3 ) (s-z m ) 

= H(s) = = A EQ.1 

v in P(s) (s-p.,) (s-p 2 ) (s-p 3 ) <s-p n ) 

The transfer characteristic H(s) is the ratio of network output voltage v out to input 
voltage Vj n , and the two polynomials are designated Z(s) and P(s) respectively. Once 
the transfer characteristic has been found as the ratio of these two polynomials, they 
may be factored into the form above. In Equation 1, the coefficients designatged z\, 
Z2,..., z m are called the zeros of the transfer characteristic and the coefficients pi, 
P2,..., p n are known as the poles of the transfer characteristic. The letter m literally 
designates the number of zeros, and n designates the number of poles, or, 
equivalently, m represents the order of the polynomial Z(s) and n represents the 
order of polynomial P(s). 

The coefficients of the original unfactored polynomials Z and P must be real if the 
filter is to be made from "real" components. This also means that if any of the zeros 
Zj or poles pj is complex, then there will be another zero or pole present, representing 
the complex conjugate of z\ or p,. Each pair of factors corresponding to a complex 
conjugate pair of poles or zeros may be combined to result in a quadratic term with 
real coefficients. The frequency response of such a filter may be found by 
substituting the value j2nf (where j is the square root of -1) for the value of s. The 
complex value of the gain expression contains both amplitude and phase 
information. 
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The development of operational amplifiers has made possible filter realizations 
which use only resistors and capacitors. These filters usually consist of a cascade of 
stages, with each stage realizing a single real pole or a complex conjugate pole pair. 
Zeros are realized by interconnections between the stages realizing the poles. Such a 
network may be designed by factoring the polynomials describing the desired 
transfer characteristic, and then putting the poles into an order that groups the 
complex conjugate pairs separately from the real poles. Each complex conjugate 
pair is realized by a separate stage. Real poles may or may not need to use a separate 
stage. 



Impulse Response Analysis 

The description above mentioned how the frequency response of a filter may be 
determined by solving for the polynomials in complex frequency s. However, an 
alternate description of a filter is its impulse response, i.e. its response to a single 
impulse stimulation. 

The impulse response of a filter may be used to determine the response to a more 
complicated wave form by treating that wave form as a sequence of impulses of 
varying amplitude. The individual responses are accumulated, a process known as 
convolution, which is described by the equation: 



= / h( T ) 



y(t) = / h(T) x(t--r) dr EQ.2 

'o 

where h(r) is the impulse response of the filter, x(t) is the input, and y(t) the output 
of the filter at time t. 



The impulse response of a filter may be found from the complex frequency 
polynomial ratio using Laplace transforms. 



Using Partial Fractions 

One convenient method for finding impulse response consists of first expanding the 
polynomials as a series of partial fractions, P(s) is first factored into quadratic 
terms, corresponding to complex conjugate pole pairs, and first order terms, 
corresponding to real poles. The expansion is then developed using the factors, i.e. 

P(s) = (s 2 +a 1 s + b 1 ) (s 2 +a 2 s + b 2 ) (...)... (s + A., ) (s + A 2 )...(...)EQ.3 

Z(s) AtS + Bt A 2 s + B 2 .... R-, R 2 

= A + + + + + EQ.4 

PCs) s 2 +a 2 s + b-, s 2 + a 2 s + b 2 s + r, s + r 2 



NOTE 

Multiple poles with the same value require a somewhat different form of 
expansion. 
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Each term in equation 4 is then replaced by its transform, often drawn from a table 
such as Table I: 



Table H-l . Laplace Transforms 



Frequency domain term 
F(s) 



R 
s + r 



As + B 
s 2+ as+b 



Time (impulse) domain term 
f(t) 

Impulse of weight A 
Step of amplitude A 

Re" rt 

. B-aA/2 , 

e-at/2 | AcosC^/b-aZM t ) + s i n (>/b 2 -a 2 / A t) 

Vb 2 -a 2 /4 



The overall impulse response of the filter is the sum of the impulse responses 
represented by each of the individual terms in equation 4. As a result, the impulse 
response of any filter consisting of a finite number of RLC components will 
normally consist of a sum of exponentials and exponentially decaying sinusoids. 



Canonical Forms of Digital Filters 

A band-limited signal may be completely reconstructed from discrete samples of its 
values. As long as a signal is maintained in a band-limited form, it is possible to 
perform arithmetic operations on samples of the signal yielding results equivalent to 
arithmetic operations performed on the continuous signal. 



The processed samples may then be used to reconstruct the equivalent modified 
continuous signal. As long as the operations performed are linear, i.e. 



F(x + y) = F(x) + F(y) ; where F is theoperation 



then a band-limited signal will retain its band-limited nature throughout the pro- 
cessing. Digital filtering consists of processing digitized samples of signals in a 
manner similar to the methods for realizing continuous analog filters. 



Figure 1 is a block diagram of a digital filter module. Each block labeled z _1 is a unit 
delay, i.e. a delay of one inter-sample interval. The other blocks are multipliers (X) 
and adders (I). The values Aq, Aj, A2, B l5 and B2 are coefficients which determine 
the behavior of the module. 
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Figure H-l. Digital Filter Module (Second Order Section) 121J 



The stage shown in Figure 1 behaves in a manner analogous to a continuous analog 
stage which realizes a complex conjugate pair of poles. For example, if the structure 
initially has values Yl and Y2 equal to zero and is excited by a single impulse (i.e. 
one sample of unit value followed by zero-valued samples), the output may take the 
form of samples of an exponentially decaying sinusoid. The impulse response of the 
stage may be expressed as: 



h(0) 
h ( i T ) 
when B-] 
B 2 

A 
Ai 



= D + A 



e _aiT A cos (/?i T) + B si n (/3iT) fori>0 
2e _aT cos pj 



•2aT 



= D + A 



- ( 2 D + A ) e _aT c o s 0T + B e ~ al s i n /JT 
De ~ 2aJ 



G> 



|A 

■0 



H 







© 
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Figure H-2. Digital Filter Module (First Order Section) 
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The diagram of Figure 2 corresponds to a stage realizing a single real pole. Its 
impulse response takes the form: 

h(0) = D+A 

h(iT) = Ae" ffiT 
when 

B., = e~ aT 

A ' = D+A 



M 



= -De-* 1 



From the equations, it can be seen the impulse responses consist of (optional) initial 
delta functions, followed by a series of samples which are equivalent to having 
sampled an exponential decay, or an exponentially decaying sinusoid. 

Therefore, if we have a continuous filter Fl that has an impulse response which 
consists of a sum of decaying exponentials or esponentially decaying sinusoids, we 
can realize a digital filter F2 that has an impulse response whose values at each 
sample time are identical to those we would expect from Fl. This impulse response 
may be achieved by building a network of the structures shown in Figures 1 and 2, 
and summing their outputs. 

This procedure defines a type of transform from the continuous domain to the 
sampled domain, that is, the sampled domain structure implements an impulse 
response equivalent to having sampled the impulse response of the corresponding 
continuous filter. This transform is known as the "impulse invariant" transform, 
and is one of several which may be used to relate the sampled world and the 
continuous world. 

Because of the nature of the sampling process and the corresponding frequency 
folding about the sample rate, it is not possible for a digital filter to duplicate exactly 
the characteristics of a continuous analog filter. As the frequencies of interest 
approach and exceed half the sample rate, the frequency characteristics of the digital 
filter differ radically from those of its continuous counterpart. These differences 
may be shown by solving for the frequency response of the second order digital filter 
section as shown below: 



F ( j w ) = 

1 - B -i ( c o s wT-j sin wT)-B 2 (cos 2wT-j sin 2 w T ) 

Note that a periodic function of frequency results, unlike the continuous case. 

Sampled systems can be described as functions of a complex variable z, where z=e sT 
and T is the inter-sample interval. In Figure 1, each of the blocks labeled z _1 
corresponds to a unit delay of time T. It is possible to describe the characteristics of 
the block diagram of Figure 1 as a ratio of polynomials in z or z _1 . 

Consider the case of a continuous analog filter where one stage realizes a single 
exponentially decaying sinusoid. Just as such a structure corresponds to a single pair 
of complex conjugate poles, the diagram shown in Figure 1 is capable of realizing a 
single exponentially decaying sinusoid and corresponds to a single complex 
conjugate pair of poles in the complex z plane. Figure 3 shows a plot of the 
frequency response of the typical second order continuous section, and, for com- 
parison, that of a second order sampled section, for the case where the impulse 
invariant transform described above was used. 
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Figure H-3. Comparison of Digital and Continuous Frequency Response 
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Matched Z Transform 

Another method for converting from the s-plane to the z-plane is known as the 
matched z transform. This method is simply a technique for mapping each pole or 
zero of the s-plane to a corresponding pole or zero in the z-plane. A pole or zero at 
a + jb on the s-plane is transferred to a pole or zero at e( a + i b ) T on the z-plane, where 
T represents the sample interval in seconds. In polar coordinates, this z-plane 
location is (e aT , bT). The equations for the coefficients are shown below: 

Second order sections for a continuous pole pair -a±jb in the s-plane 

Bt = 2 e _aT cos bT 
B 2 = -e" 2aT 

for a continuous zero pair at -a±jb 

A-, = 2 A e" aT cos bT 
A 2 = A e- 2aT 

First order section 

for a real pole at -a 

Bt = e _aT 
for a real zero at -a 

At = -A e" aT 

This transform is not guaranteed equivalence in either frequency or time domains, 
although pole positions correspond to the impulse invariant transform. The 
transform is sometimes useful for conceptually estimating the influence, on the 
resulting filter characteristic, of moving the poles or zeros. In general, it is easier to 
predict the impact on frequency response of moving a pole or zero in the s-plane 
than in the z-plane, because the s-plane axes are more directly related to frequency. 
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The matched z transform allows a one-to-one correspondence of poles and zeros in 
the s-plane to poles and zeros in the z-plane. One use of this transform is therefore to 
aid manipulation of the positions of poles and zeros in the z-plane in order to 
achieve some desired frequency response. 

Rather than attempt to do the complete design on the s-plane and then transform to 
the z-plane to achieve the desired filter, the designer manipulates the poles and zeros 
in the s-plane while observing the frequency response of the digital filter resulting 
from the matched z transform. Once the desired characteristic is obtained, the 
coefficients of the filter are determined by using the transform. This technique has 
been implemented in the SPAC20 Compiler, and aids the empirical design of filters 
when mixtures of continuous and digital filters are used. 



NOTE 

When dealing with complex frequencies in the s-plane or "TS" plane, the 
SPAC20 Compiler accepts and displays values in Hertz, rather than the 
traditional radians/sec of the s-plane. The equations shown here utilize the 
radian/sec representation of frequency. If the frequencies are given in 
Hertz, they must be multiplied by In to connect them to the radian/sec form 
before use in the equations above 



Bilinear Transform 

This transform is a method for mapping the s-plane (jw) frequency axis into the 
z-plane unit circle, such that the continuous s-plane frequency scale from DC to 
infinity is mapped into a corresponding frequency range of DC to one-half of the 
sample rate. Therefore, this transform distorts the frequency axis or the frequency 
characteristics of the filter. 



However, the transform does have the property that the shape of the frequency 
characteristics of the analog filter is preserved with the exception of the frequency 
distortion. It is common to pre-distort the characteristics of a continuous filter to 
compensate for the transform's distortions, and thereby implement a sampled filter 
with a frequency response very closely resembling that of its continuous counter- 
part. The equations for the bilinear transform are shown below. (A macro 
implementing this transform, is available for use with the SPAC20 Compiler. It 
appears in Chapter 10.) 



Bilinear Transform Equations 

The equations for the Bilinear Transform are: 

2 (1-Z- 1) (2/T + S) 

S "* T (1+Z-1> Z "* (2/T-S) 

where T is the sampling interval. 
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That is, given a polynomial expression (in s) for the transfer characteristic of a 
continuous filter, a corresponding digital filter may be found by substituting 

2 (1-Z-1) 



T CI+Z" 1 ) 



for each occurrence of s, and then converting the resulting expression to a ratio to 
two polynomials in z. 

These functions map the jw axis of the s-plane onto the unit circle of the z-plane. 

i.e. when 

s = jQ 

where Q is the analog frequency (in radians/sec) 

_ (2/T+jQ) ,_, _ , 

1 = (2/T-jQ) ° r ,Zl " 1 

The Bilinear Transform maps the point 

Q = to z = 1 
Q = oo to Z = -1 

and the entire left half plane into the unit circle. 

A nonlinear distortion is produced by the mapping of the analog ]Q axis onto the 
z- plane unit circle. This distortion is given by the mapping 

r. - o it + ht/o ., 2 tan" 1 (QT/2) 
Q = 2/T tan WT/2 W = — 

where Q is an analog frequency and W is a corresponding digital frequency in 
radians/sec 

As an example of using the Bilinear Transform, consider the design of a lowpass 
digital filter with a cutoff frequency of f c (in Hz): 



1) Convert f c to radians/sec and find the proper prewarping for the equivalent 
analog filter: 

2 U T 

Q, =__ tan ZlL W r = 2nf r 



2) Design an analog filter that will satisfy the given specification with a lowpass 
cutoff frequency of Q c in radians/sec or Q c /2n Hz. Express the transfer func- 
tion as a ratio of polynomials in s. 



3) Use the bilinear transform on the transfer function in s (obtained in step 2) to 
obtain a transfer function in z, i.e., replace each occurrence of s with 

2 (1-z-i) 



T <1+z- 1 > 



The digital filter which corresponds to the z-plane expression from step 3 (figure 4) 
will now have the desired cutoff characteristic. 



H-8 



SPAC20 Compiler 



Design of Complex Digital Filters Used in the 2920 



DIGITAL 

FILTER 

RESPONSE 



T 2tan-i % J 



HM 




Figure H-4. Transfer Function From Q to w 
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Note that this transform may alter the number of poles and zeros involved. If poles 
and zeros are independently transformed, redundant poles or zeros may occur. 
Using this transform requires careful elimination of such redundancies. 



Implementing Filters with the 2920 

Once you have determined the locations of your filter's poles and zeros in the 
z-plane, converting this structure into 2920 code is relatively straightforward. In the 
blocks of Figures 1 and 2, there are three basic operations performed to achieve 
digital filtering action: a unit delay represented by the symbol z -1 , and addition and 
multiplication. 

For time invariant filters, i.e. those for which the R's, L's, and C's used are fixed 
and stable with time, the multiplications performed will be of some variable Yi by a 
constant represented by the values A , A\, A 2 , Bj, or B 2 . The goal of the 2920 
programmer is to implement these functions in a minimum of 2920 instructions. 

The blocks labeled z _1 correspond to unit delays, i.e. delays of one sample interval. 
The sample interval is the time it takes for the 2920 to make one pass through its 
program. The value on the output side of a delay block represents the value 
computed at the block's input on the previous pass through the program. 
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The delay can be realized by a RAM location which retains the data from the 
previous pass until it is needed. A single LDA instruction of the 2920 is sufficient to 
implement a unit delay block. Figure 1 shows two delay blocks; thus two LDA 
instructions and two RAM locations are required. These instruction have the form 
shown below: 

LDA Y2, Y1 , R00 
LDA Y1 , YO, R00 

After executing these two instructions, the RAM location designated Y2 contains the 
value of Yl from the previous pass, and Yl contains the value of YO from the 
previous pass. To complete the filter realization, it is sufficient to complete the 
calculations of the new value of YO from the current values of input, Yl, and Y2, 
and then compute the output from YO, Yl, and Y2. The new value of YO involves 
multiplication of Yl and Y2 by the constants Bl and B2. The instruction set of the 
2920 permits implementing these multiplications-by-constants as a series of addition 
and subtraction steps. 



In general, the coefficients are not realized exactly, but rather are approximated as 
closely as necessary to meet the filtr specifications. This permits minimizing the 
number of 2920 program steps required to realize the multiplications. 

Each ADD or SUB instruction of the 2920 can be thought of as adding a value to (or 
subtracting it from) the destination operand (e.g. Yl in the last instruction above). 
The value used in that operation is the product of some power of two and the source 
operand (e.g. Y0 in the last instruction above). There is a simple algorithm for 
converting a multiplication by a constant into a series of additions and subtractions. 
It consists of choosing, at each step, the particular power of two and the specific 
addition or subtraction operation which will minimize the error, i.e. produce the 
closest approximation to the desired value. 



For example, consider the coefficient Bl = 1.8. The power of two that would most 
closely approximate this value would be 2 1 , or 2. This value may be realized with a 
single 2920 instruction: 

ADD Y0, Y1 , L01 



The error in realizing Bl, after this step, would be 2-1.8=+0.2. If such an error is 
too large, another 2920 instruction step is added. To reduce an error of +0.2, the 
programmer subtracts the value 2- 2 or 0.25 from the approximation, giving a net 
approximation of 1.75 and an error of -0.05. If -0.05 is still too large an error, an 
additional 2920 step equivalent to adding the source operand multiplied by 2 A = 
0.0625 can be added. A net approximation of 1.8125 results, with an error of 
+0.0125. This process can be repeated until the coefficient is realized with adequate 
accuracy for the filter requirements. A more powerful version of this, algorithm is 
used in the 2920 Signal Processing Applications Compiler's CODE generation 
command. 

Because there are two coefficients in the filter, two sequences of operations must be 
defined as described above. As the procedure described performs an addition to the 
destination location, it is necessary to initialize the destination location. This can be 
done by clearing the location (e.g. by subtracting the location from itself) or by 
converting an addition operation to an LDA and placing it as the first step of the 
sequence. The last steps to realize the filter involve adding the weighted input 
variable and computing the output. Procedures similar to those above are used for 
the multiplications and additions needed for these operations. 
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Some Practical Considerations 

The procedures described above show how second order filter sections can be 
realized. In selecting the gain for the filter, the user should consider the scaling of 
the variables within the filter. Improper scaling can result in a number of problems. 

If the variables are very small, it is possible that the 25-bit word width will not 
provide enough resolution, and significant truncation noise will be introduced. 
Because a second order filter of this type may perform the equivalent of integrations 
in which results are obtained by summing many small values, roundoff error can 
occur in unexpected ways. 

If the variables are scaled too large, overflow saturation may result, with behavior 
very similar to that occurring in an analog circuit when the signals exceed the 
dynamic range of the amplifiers. However, an additional consideration may be 
important in 2920 realizations of second order sections. As coefficient products are 
developed by series of additions and subtractions, intermediate values may be larger 
than those finally obtained. 

In general, it is necessary to provide sufficient margins when scaling input variables 
to ensure that overflow saturation does not occur for intermediate values. 
Sometimes the sequence of calculations can be ordered to minimize potential 
overflow saturation. 

A third method to prevent intermediate overflow saturation is to compute some 
fraction of Y0, restoring it to full value when it is transferred to Yl, such as shown 
in Figure 5. This of course adds some noise to the final output, lowering the 
accuracy somewhat. 

The coding generated by the SPAC20 Compiler is already ordered and scaled in this 
manner to minimize overflow. The user must still address the issue of scaling for 
input and for signals propagated from earlier stages. 



►©— 




B 2 /4 



Figure H-5. Method for Preventing Intermediate Overflow 121533-38 
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(If overflow occurs, it will be when Y0 is increased and loaded to Yl .) 

No additional instructions are necessary in general, because the extra multiplications 
shown in Figure 5 can be performed by modifying the instructions of the original 
realization. 

When a filter consists of a cascade of second order sections, code can be saved by 
performing any gain trimming calculations at just one point in the cascade. 
However, to maintain properly scaled variables, the gain for the inputs to each stage 
should be adjusted by the appropriate power of two. The proper scaling factor can 
be determined by evaluating the maximum gain from the input to each point in the 
cascade, starting with the first stage. The gain for the input to that stage is adjusted 
to ensure that the overall gain does not exceed unity at any frequency. After each 
stage is adjusted, the process is repeated for the next stage. See Appendix J for more 
details. 



Very Low Frequency Fitters 



As mentioned above, the processes occurring in the recursive second order section 
are equivalent to integration. When very low frequency filters or filters with very 
high Q's must be realized, even the 25-bit word width of the 2920 may not provide 
adequate protection from truncation error. In some cases it may be possible to 
reduce the clock rate (and therefore sample rate) which will reduce coefficient 
precision requirements. 

When other functions prevent reduction of the sample rate, or when the predicted 
value of clock rate must be lower than the minimum permitted by the 2920, alternate 
programming techniques must be used. (The 2920 word size and the dynamic range 
of the variables being processed establish a maximum ratio of sample rate to 
frequencies of interest.) 

For very low frequency filters, the effective sampling rate must be reduced or the 
effective precision of the processor must be increased. One approach, extended 
precision arithmetic, appears possible but cumbersome. When very low frequencies 
are being used, the coefficients Bi and B 2 approach very closely to the values +2 and 
-1 respectively. By realizing the filter as shown in Figure 6, the small terms Bj— 2 
and B2+I are isolated from the large terms and scaled upwards by some power of 
two. The equivalent multiplications may then be done using single precision, which 
is converted back to extended precision by a 2-" scaling. 

Extended precision arithmetic may be executed using masks derived from the 
constants, or by conditional additions. In either case, carries generated by the low 
order word are added to the high order word to maintain carry propagation .,The 
carries may be simulated in one of the high order bits of the low order word, tested 
via conditional operations or masking, and then removed by masking or conditional 
addition of a negative constant. Table II shows an extended precision add routine. 



Table H-2. Extended Precision Add Routine (48 Bit Precision) Technique 
Uses Simulated Carry at 2nd Bit From Left of Low Order Word 



ADD 


YL, 


XL, 


R00 


add low order word (25 bits + carry) 


LDA 


TMP, 


YL, 


R00 


copy word to temporary location 


AND 


TMP, 


KP4, 


R00 


mask off simulated carry bit 


SUB 


YL, 


TMP, 


R00 


clear carry from low order word 


ADD 


YH, 


XH, 


R00 


add high order words 


LDA 


TMP, 


TMP, 


R13 


move carry to right 


ADD 


YH, 


TMP, 


R10 


add carry to high order word 
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Figure H-6. Very Low Frequency Filter 



When low frequency filters must be realized, it is in general more convenient to 
reduce the sample rate rather than attempt to extend the precision of the variables. 
The sample rate may effectively be reduced by using the conditional load operation 
triggered by an oscillator run at a submultiple of the sample rate. The filter calcula- 
tions go to completion every nth cycle. Such an oscillator can be realized by the 
program shown in Table III. 



Table H-3 



; Oscillator 

SUB OSC, KP1 , R05 

LDA DAR, OSC, R00 

LDA OSC, KP3, R00, CNDS 

ADD OSC, KP3, R05, CNDS 

; conditional filter implementation 

LDA Y2, Y1 , R00, CNDS 

LDA Y1 , YO, R00, CNDS 



subtract constant KP1 fromOSC 
move to DAR for sign test 
re- initialize if negative to 
99 times KP1 



delay occurs only on eye ling 
of osc i I lator 



; remainder of filter calculations are done unconditionally - result is valid 
; only on cycling of oscillator 



The filter code generation may be done with the SPAC20 Compiler by using the 
effective sample rate. To use this filter at the normal sample rate, the output code 
must be edited to add the CNDS operations to the delay realization. 

A constant value is subtracted from a RAM location on each pass through the 
program. If (and only if) that operation causes the result to be negative, the condi- 
tion for re-initializing the oscillator is met. A conditional load operation restores the 
oscillator to a positive value. Thus the oscillator cycles at a submultiple of a sample 
rate (at 1/100 in the Table III example.) 
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The filter itself is realized using the same equations as are used in any second order 
section, with the exception that the delay realization operations i.e. loading Yl to Y2 
and Y0 and Yl, are performed only on those program passes which re-initialize the 
oscillator. Because the oscillator calculations only produce re-initialization every nth 
cycle, a sample rate has been achieved equal to the 2920 sample rate divided by n. 

On occasion, it may be desirable to operate one or more stages of the filter at a 
higher sample rate than that of the 2920. For example, it may be possible to use a 
lower cost external anti-aliasing filter by sampling the inputs at a higher than normal 
rate, and performing some of the anti-aliasing using a digital filter stage operating at 
this higher rate. Subsequent processing of the data is performed at the nominal rate 
of the 2920. 

One means for achieving the higher sample rate it to use two copies each of the 
sampling routine and the anti-alias digital filter section. Figure 7 shows the impact 
on the external anti-alias requirements obtained by using the double sample rate 
technique. External anti-alias requirements may also be reduced for 2920 outputs by 
the use of interpolating digital filters, i.e. filters which compute values between 
successive samples. 

Interpolating filters may also be realized by operating a filter stage at twice the 
sample rate by using two copies of the program withinin the 2920. There are two 
options for the input of such a filter operating at twice the sample rate. The same 
input sample may be used for both copies of the program, or one copy may use a 
zero-valued input. The latter case resembles using an impulse source where the 
former case is more like a sampled and held source. The methods produce somewhat 
different frequency responses. 

The SPAC20 Compiler can be coerced to produce code for this mixed sample rate 
implementation. To accomplish this, set the TS to the faster rate (say 3 times the 
2920 program loop rate) and, using the CODE command, generate code for the anti- 
alias (low-pass) stages of the filter. Three copies of this code must appear in the final 
program. 

Then set the TS down to the 2920 program loop rate, and generate code for the 
remaining stages of the filter. One copy of this code must appear in the final 
program. 

At this point, the filter responses which can be graphed and otherwise examined are 
relatively accurate reflections of the true behavior, at least below half the slower 
sample frequency. This assumes that the signals are transformed between the stages 
using the impulse method (either true input or zero) as opposed to the hold method 
(either true input or held true input). 

In most of the examples described above, a cascade of filter stages has been 
assumed. However, when the impulse invariant transform is used, an alternate 
realization could be found by expanding into a. sum of partial fractions, evaluating 
the impulse response associated with each fraction, and realizing the output of the 
filter as the sum of the section outputs. The resulting realization is shown in Figure 
8b as opposed to the cascade structure of Figure 8a. In some cases, the parallel 
structure may be less sensitive to variable scaling than the cascade structure. 
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EXTERNAL ANTI-ALIAS 
FILTER 



BW f s -BW f s 



a. Original spectrum showing bandwidth of digital processing. 

External anti-alias filter must pass below BW, stop beyond f s -BW 



EXTERNAL ANTI-ALIAS 
FILTER 




b . Spectrum using double rate sampling. 

External filter passes BW, stops beyond 2f s -BW, internal digital filter performs 
rest of anti-alias function. 



Figure H-7. Effects of Double Rate Input Sampling 
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Figure H-8a. Cascade Structure for Complex Filter 

(Directly Derived From Matched Z or Bilinear Transform) 
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Figure H-8b. Parallel Structure for Complex Filters 

(May Result From Impulse Invariant Transform) 
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The formulas by which the filter response keywords are calculated are given below. 
They depend upon s-plane or z-plane representation of the locations for poles and 
zeros. Three distinct graphs are used to indicate the quantities named in the 
formulas for AGAIN, and four additional graphs are referred to by the formulas for 
PHASE. Poles are indicated by the character X, zeros by 0. The character a shows 
the object's real part (or projection), b shows its imaginary part, and f indicates the 
varying frequency of interest. These letters then appear in the formulas. For z-plane 
graphs, R indicates the length of the vector from the origin to the pole or zero, and 
theta (0) the vector's angle. 

GAIN, MAGAIN, GERROR, and MSQE are defined in terms of AGAIN. GROUP 

is the negative of derivative of PHASE with respect to frequency. The formulas are 
shown in the simplest relation to the graphs. Simplification, grouping, and recom- 
bination of terms would in some cases produce more compact formulas, but their 
meaning and relation to the positions of poles and zeros would be obscure. In some 
cases, the result of such manipulations is in fact much more complex than the 
original formulation, though it can have computational benefits for the efficiency of 
a tool such as the 2920 Signal Processing Applications Compiler. 



AGAIN 



AGAIN = 



TT D I STi 

Z i 

TT DI STi 

Pi 



AGAIN is the ratio of two products: the product of all the distances of the zeros of 
the filter divided by the product of all the distances of the poles of the filter, where 
distance means the vector distance from the frequency in question (on the vertical^ 
axis) to the position of the zero or pole (or complex conjugate of a pole). 



S-PLANE 



REAL POLE OR ZERO at -a 



DIST(f)- ^ 2 "*" a 2 "here N = no rma L i zat i on factor 
N = (1+a) 



121533-29 COMPLEX POLE OR ZERO at (-a + jb), (-a-jb) 




DIS 



T ( f ) = (>/a 2 +(f-p)~2) (Va 2 +(f + b)2) 



where the norma L i zat i on factor N = ( 1 + \/a 2 + b 2 ) 2 
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SAMPLED S-PLANE (sampled at T) 



121533-29 



REAL POLE OR ZERO at -a 



DIST(f ) = | 1-e-2naT * e -i2nfT | 



COMPLEX POLE OR ZERO at (-a + jb),(-a-jb) 




DIST(f) = 1 1-(2e- 2naT cos2nbT) e" 2 ")^ + e - 4 "«T* e -4.ijfT j 
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Z PLANE (sampled at T) 




REAL POLE OR ZERO at R, 



DIST(f) = | 1-Re-J2nfT | 
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COMPLEX POLE OR ZERO at R,0 




DIST(f) = | C1-Re-i©e-i2nfT> C1 -Re + J©e"i 2" f T ) | 
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GAIN (f ) = 20 LOG 10 



AGAIN (f) 



GREF 



units i n dB 



GREF = gainat reference frequency 
s p e c i f i e d b y u s e r 



MAGAIN = 



max { AGAIN <f , ) } 

f i in FSCALE 



GERROR(f) = 



GAIN(f) - UBOUND(f) 

if GAINCf) > UBOUND(f ) 



= < GAIN(f) - 



k 



LBOUND(f ) 

i f GAINCf) < LBOUND(f ) 



otherwi se 



MSQE = 



4 



1_ N (GERROR(fi))2 
N E 



i=1 



N = numbe r of po i nt s i n FSC A LE 
f i in FSCALE 



PHASE = ^ 0i " ^i ( units are radians) 

Zi p. 



S-PLANE 



REAL 



G = tan" 1 ± 
a 



COMPLEX 



= tarr 1 /f _ b\ + tan" 1 / f + b 



(~) 



{■*?) 
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SAMPLED S-PLANE (sampled at T) 



REAL 



= ang le of (1 -e- 2naT • e-i 2nfT ) 



angleofa+jb = tan -1 b_ 

a 



COMPLEX 



= angle of 1 -,2e -2naT cos 2nbT e~ 2,t i fT + e~ 4naT -e~i 4nfT 



Z PLANE (sampled at T) 



REAL 




= ang Le of 1 -Re _2 i nfT 



121533-32 



COMPLEX 




= angle of (1-Re-J®e-J 2nfT ) (1 -Re + i e"J 2nfT ) 



121533-33 



GROUP DELAY: 



GROUP(f), = ^1. <jphase 
2tt d f 



With HOLD ON, AGAIN is multiplied by I sin(x)/x |, where x=TS*FREQ*PI 
which causes GAIN to be corrected by adding 20 logio I sin(x)/x I and PHASE to be 
corrected by adding x. GROUP is corrected by subtracting TS/2. 

With HOLD OFF, the above corrections are omitted. 
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CONSIDERATIONS 



Scaling 



Each stage of a filter performs various arithmetic operations, which have the poten- 
tial for causing overflow saturation if the numbers coming in are too large. Thus the 
issue arises of scaling down such input to avoid inadvertent overflow. If the signal 
input to the filter were a pure sine wave, then the peak AGAIN for each stage would 
indicate how incoming signals needed to be scaled in order to avoid saturation or 
overflow within that stage. That is, if the peak AGAIN under these circumstances 
were 50 for stage 1 , the next higher power of two should be used to scale the input. 
Thus a right shift of six, equivalent to dividing by 64, would be the correct scaling, 
e.g., 

LDA INPUT, DAR, R06 

If the first two stages taken together indicated an AGAIN peak of 250, the input to 
the second stage needs only an additional reduction factor of 4, i.e., rightshift 2, as 
part of the scaling has already been done at the input to the first stage. Successive 
stages repeat this reasoning, using the cumulative effect (product) of all earlier scal- 
ing factors to determine what, if any, additional scaling is needed. (Note: set HOLD 
OFF when using AGAIN to determine scale factors, since the HOLD compensation 
really does not affect the signal until it leaves the 2920 chip.) 

Because inputs are limited to the range plus-or-minus 1.0, the largest possible 
instantaneous output of a filter may be found by integrating the absolute area over 
the impulse response of the filter. In general this value is unnecessarily conservative, 
and may result in excessive truncation error. 

Even assuming this input scaling has been performed, it is possible that intermediate 
calculations within a filter stage will cause overflow. For example, warning messages 
produced by the Compiler in the code may say, e.g., 

''.-NOTE: MAKESURESIGNALIS<0.5 47'' 



indicating such intermediate overflow will occur unless the expected maximum out- 
put signal amplitude is less than 0.547. 

If the input to a stage is scaled so that the expected maximum output signal is less 
than 0.25, such intermediate overflow cannot occur (for poles and zeros within the 
unit circle on the z-plane). 

As a rule of thumb, it should be sufficient to use four times the MAGAIN (rounded 
up to the next power of 2) as the scaling needed for each stage. That is, the user 
should ensure that the scaling before any stage is at least four times the MAGAIN 
due to the combination of all previous stages and the present stage under 
consideration. 

During the coding process, if /3i is implemented first in the coding, a warning 
message will appear, advising the user to keep the signal below a certain level. If the 
above scaling factor of four times MAGAIN has already been performed, then the 
purpose of these messages has already been accomplished. 
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Signal Propagation 



In the code output from the SPAC20 Compiler, you will find, usually once per 
module, an ADD or LDA instruction using names like INO, INI, followed by the 

stage label, e.g., INO Zl for zero 1. These are the instructions which must be 

replaced using the correct scaling and appropriate input source, which depends on 
the sequence and combination of poles and zeros, as follows: 

The table below indicates the number of inputs and outputs for the four kinds of 
poles and zeros. A complex pole takes in one signal and produces three output 
signals, whereas a complex zero uses three inputs and produces one output. A real 
pole has one input and two outputs, while a real zero takes in two signals and 
outputs one. 



(using hypothetical poles and 


zeros labeled 3 (for complex) and 2 (for real). 




Input 


Signal 


Output 


Signal 




Signals 


Delay 


Signals 


Delay 


Complex Pole 


IN0_P3 


Signal Input, 
not delayed 


OUT0_P3 
OUT1__P3 
OUT2_P3 


Signal Input, 
not delayed 
Delayed 1 sample 
interval 

Delayed 2 sample 
intervals 


Real Pole 


IN0_P2 


Signal Input, 
not delayed 


OUT0__P2 
OUT1_P2 


Signal Input, 
not delayed 
Delayed 1 sample 
interval 


Complex Zero 


IN0_Z3 
IN1_Z3 
IN2_Z3 


Signal Input, 
not delayed 
Delayed 1 sample 
interval 

Delayed 2 sample 
intervals 


OUT0_Z3 


Signal Input, 
not delayed 


Real Zero 


IN0_Z2 
IN1_Z2 


Signal Input, 
not delayed 
Delayed 1 sample 
interval 


OUT0_Z2 


Signal Input, 
not delayed 



Merging Code for Poles and Zeros 

From the table it is easy to perceive the proper meshing of the code for a complex 
pole followed by that for a complex zero: 

IN0_Z3 EQU OUT0_P3 
IN1_Z3 EQU 0UT1_P3 
IN2_Z3 EQU 0UT2_P3 

This provides the correct, suitably delayed pole output signals to the appropriate 
zero inputs. Similarly, to merge the code for a real pole followed by a real zero, you 
can use 

IN0_Z2 EQU OUT0_P2 
IN1 Z2 EQU 0UT1 P2 
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If, however, a complex pole is followed by a real zero, then as the table indicates you 
must select the pole output with the correct delay, i.e., 

IN0_Z2EQU OUT0_P3 ; no delay 
IN1_Z2EQU 0UT1_P3 ; delay 

A complex pole followed by two real zeros cannot be directly merged. The first zero 
can be merged with the pole as above. Then the signal needs to be propagated to the 
second real zero (here labeled Z22). For example, the code below 

IN0_Z22 EQU OUT0_P3 
LDA IN1_Z22, IN0_Z22 

will accomplish this for a real zero. An equivalent method in the real case is to create 
a pole at 0,0, Z and then merge it with the zero. For a complex zero, the code below 
should be used: 

IN0_Z3 EQU OUT0_P3 
LDA IN2_Z3, IN1_Z3 
LDA IN1_Z3, IN0_Z3 

Use of Temporary RAM Locations 

The coding for equations of the form YY = C*YY is only optimal assuming no 
scratch RAM locations are to be used. You can often improve it by the simple expe- 
dient of coding in two steps, first saying 

CODE XX = 1 . * YY 

and then, after saving that code, enter CODE YY = C * XX. Using XX as a scratch 
variable in this way can be a useful technique. 

If more than 16 bits of precision is needed in constants, say in PERROR or ERROR 
constraints, the code produced with the standard SPAC20 algorithms may suffer. 

C0DEYY= (1 +1/2**17) *XXERR<0 

is an example. Five instructions are generated where 3 could suffice. One way 
around this is to code in several steps, e.g., 

C0DEYY = C*XXERR<(1/2**13) 

DEFINE .ERR0R$$SAVER = ERR 

CODE XTMP = (1 /2**13) * XX 

C0DEYY= (.ERR0R$$SAVER*2**13) * XTMP + YY ERR<(1/2**10) 

This effectively combines coding for the top 13 bits and for the least significant 13 
bits. 
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Error conditions encountered by the SPAC20 module cause a numbered error 
message to print on your console. 

Since commands are read on a line-by-line basis, the Compiler will not flag any error 
until after an entire line has been entered. When the first command error is found, 
command processing stops and the offending line has no further effect on any 
internal variables. 

If a syntax error is encountered by the Compiler during a multi-line compound 
command, the error is reported and the line is ignored. Whenever possible, the lines 
already successfully entered in the compound command are kept and input may 
resume. Sometimes the compiler finds it impossible to do so and in this case the 
entire compound command is lost. The prompt for the next input line indicates 
which of these options was selected: "....*" indicates continued compound 
command input; "*" indicates new command input. 

Errors during compound command execution will terminate processing, leaving the 
compile-state intact as of the last successfully completed command. 

Error numbers CO to CF are warnings of conditions which are probably undesired. 
These warnings do not terminate compound command processing. 

The following list of error messages does not include those which can come directly 
from ISIS-II. These appear in a separate list after the Compiler's messages. 

In some rare cases, the error number may be printed without its associated message, 
as in 

ERR80: ? 

This means an Error 80 was detected but some other (probably unrelated) problem 
prevented the Compiler from printing the message, e.g., error message file 
SPAC20.OVE is missing. 



ERR 71: 



ILLEGIBLE NUMBER 



ERR 72: HELP FILE MISSING 

ERR 73: SAMPLE RATE UNDEFINED 



ERR 74: 



ERR 75: 



GREF AGAIN ZERO 



NEGATIVE RADIUS 



A floating point number input cannot 
be deciphered. 

The help file SPAC20.0VH is missing. 

TS has not yet been assigned. TS 
must be assigned a nonzero postive 
value before sampled poles and 
zeros can be created or before IM- 
PULSE or STEP responses are ex- 
amined. 

The frequency specified in the GREF 
has absolute gain zero and this can- 
not be used as a reference level. 
Select a different GREF frequency. 

Poles or zeros defined in the Z-plane 
must have positive radius. A negative 
radius is equivalent to a positive 
radius with an angle offset of 180° =n 
radians. 
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ERR 76: POLE/ZERO NOT SAMPLED 



ERR 77: CONSTRAINT TOO SEVERE 



ERR 78: ANGLE > PI OR <= -PI 



ERR 79: EXTRA CONTINUOUS ZEROS 



ERR7A: ILLEGAL CODE COMMAND 



ERR7B: INTEGER NEEDED 



ERR 80: SYNTAX ERROR 



ERR 81: r INVALID TOKEN 



ERR 83: INAPPROPRIATE NUMBER 



ERR 84: PARTITION BOUNDS ERROR 



ERR 85: ITEM ALREADY EXISTS 



ERR 86: ITEM DOES NOT EXIST 



A pole or zero must be sampled 
before code can be generated. Move 
it to the TS or Z planes. 

The pole or zero or multiplication 
cannot be coded within the instruc- 
tion constraint specified. Try relaxing 
the INST constraint. 

Poles or zeros in the Z-plane must 
have angle between ±n. Take the 
desired angle mod 2n to obtain this. 

The STEP or IMPULSE time 
responses cannot be calculated 
because there are more continuous 
zeros than continuous poles. Such a 
combination cannot be physically 
manifested. 

The code command issued does not 
exist, e.g., CODE Y = 1*X + Z. 

An integer valued expression is 
needed in context e.g., POLE 1.5. 

The token flagged is not one that is 
allowed in the current context. 

The token flagged is illegal because it 
does not follow the rules for a well- 
formed token. The line is ignored and 
you must re-enter your intended 
command. Check the correctness of 
the syntax and variable-names used. 
A string longer than 255 characters 
can result in this error. 

The value printed on the preceding 
line is not appropriate in the current 
context. Some contexts allow only 
certain numbers, e.g., TS must be 
positive. 

The partition values entered in a 
command are not correct. Either the 
left part of the partition is greater than 
the right part, or the values of the 
partition extremes are out of range in 
the current context. For example, 
Poles 3 thru 2. 

The symbol or macro entered in a 
define command is currently defined 
in the symbol or macro table. You 
may need to validate the current 
usage of this symbol or macro, or 
perhaps merely use a different spell- 
ing to maintain the distinction. 

The item printed on the preceding 
line does not reside in the symbol 
or macro table. It may have been 
removed in an earlier test session, 
or it may be in a change you haven't 
inserted yet. 
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ERR 90: 



MEMORY OVERFLOW 



ERR91: 



STACK OVERFLOW 



ERR 92: 



COMMAND TOO LONG 



ERR 94: NON-CHANGEABLE ITEM 



ERR9D; LINE TOO LONG 



ERRAO: TOO MANY PARTITIONS 



ERRB9: NO HELP AVAILABLE 



WARNC8: F. P. INVALID OPERAND 



WARNC9: F. P. OVERFLOW 

WARNCA: F. P. UNDERFLOW 

WARCB: F. P. ZERO-DIVIDE 

WARNCC: F. P. DOMAIN ERROR 



Either too many poles and zeros have 
been defined (more than 20), or too 
many macros or symbols have been 
defined or some other internal buffer 
size has been exceeded. If the 
message 
MEMORY RECLAIMED 

appears on the next line, success 
may be obtained by simply reissuing 
the command which caused the 
original overflow. Before doing so it is 
recommended to delete any unused 
symbols or macros first. 

The capacity of a statically allocated 
internal stack has been exceeded. 
This is probably due to an exces- 
sively complicated command, e.g., 
one with 20 parenthesis pairs. An 
examplewould be 
DEFINE ,DAR$SAVED = 
(((((((((((((((((DAR))))))))))))))))) 

Too complicated a command due to 
number of operators, most probably, 
as in 

DEFINE .TEMPFUNC = 

1+8*9-7/44*.... 
out to many operators. Break it up in 
several smaller commands. 

An attempt to alter a read-only item, 
e.g., INST. 

Command line was longer than 122 
characters. 

An fscale or Ibound or ubound has 
been specified with more than the 
maximum number 10 of piecewise 
linear segments. 

Help has been requested for a help 
item which has no help message. 

The program tried to use a value 
resulting from an underflow or 
overflow condition. If this message 
persists, try flushing the Compiler's 
internal storage with the command 
XSIZE = XSIZE. 

A value larger than 10 times the 
largest allowable number occurred in 
some expression. 

A value smaller than the smallest 
allowable number occurred. One 
example is 1/largest#. 

Dividing by zero was attempted. 

One example would be the square 
root of a negative number. 
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The last five warnings are flagged during command execution due to an 
inappropriate action or result for a floating point operation. See the documentation 
for the FORTRAN floating point libraries for further details. 



ERRE7: ILLEGAL FILENAME 



ERRE8: ILLEGAL DEVICE 



ERRE9: FILE OPEN FOR INPUT 



ERREF: FILE ALREADY OPEN 



ERRFO: NO SUCH FILE 



ERRF1: WRITE-PROTECTED FILE 



ERRF3: CHECKSUM ERROR 



ERRF6: DISKETTE FILE REQUIRED 



ERRF9: ILLEGAL ACCESS 



ERR FA: NO FILE NAME 



ERRFH: NULL FILE EXTENSION 



The filename specified does not 
conform to a well-formed ISIS 
filename. See ISIS Manual for valid 
formulation and device labels. 

Illegal or unrecognized device in 
filename. An invalid device label was 
used, e.g., :D0: instead of :C0, or 
something unrelated such as :PQ:. 
See ISIS Manual for valid list. 

Attempt to write to a file open for 
input, e.g., PUT :CI:, a file predefined 
as console input. 

Attempt to open a file that was 
already open. 

The file specified does not exist. 
Possibly a wrong or missing device 
label, as in typing :F2:FILE when you 
meant :F3:FILE, or a file missing due 
to forgetting to copy it onto a new 
disk. 

The file named for output is 
write-protected and cannot be over- 
written. 

An overlay file cannot be loaded 
because it has become trashed. 

A file was referenced which needs a 
diskette. 

Attempt to open a read-only file for 
the purpose of storing data (e.g., 
specifying :CI: as the list device) or to 
open a write-only file as a source of 
data (e.g., :LP: in an include 
command). 

No filename specified for a diskette 
file (e.g., no filename following :F2:). 

An expected filename extension was 
not found (e.g., :F2:FILT.). 
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abbreviations, 2-4, F-2, Appendix B 

ABS, B-l 

accuracy of code, 7-4 

see also precision 
ACOS, B-l 

actual parameters, 9-3 
add to a file, see APPEND 
adders, H-3 
advanced techniques 

pertinent to filters, Chapter 10 

re other signal processing, Chapter 1 1 
AGAIN, 1-18, 2-5, 5-1,5-2, 5-4, B-3, 

1-1, J-l 
alias, 4-5 
All-pole filter coding 

example macro, 10-9 

resulting file, 10-14 
ampersand, 2-2, 3-1, F-l 
amplitude 

desired output 1-1 

and phase information in complex gain, 
H-l 
analog filters, H-l 
analog-to-digital, 1-4, G-l 

see A-to-D 
AND, 9-9, B-l 
ANGLE, 2-9, B-l 
apostrophe, 2-3, 6-3, 9-4, 9-5 
APPEND, 1-3, 2-6, 7-3, 8-4, 8-6, 9-1, B-2 

default objects, 8-4 
arithmetic expression, 2-8, 4-2, E-5 
ASCII, 2-2 
ASIN, B-l 
Assembler, 1-2, 7-1 

code submission to, Appendix G 

options, G-2 

tasks before invoking, G-l 
asterisk, 1-2, 2-2, 2-8, 2-9, 3-1,6-2, 8-1,9-1 

see also double-asterisk, 
AT, 5-1,5-2, B-4 
at-sign, 2-2 
ATAN, B-l 
A-to-D conversion macro, 

definition, 11-3 

invocation, 10-10, 11-6 
attenuation, 6-2 
AUTO, 6-2, B-4, C-l 
avis, second-stage ariel evolution, 



band-limited signal reconstruction, H-3 
best yet code, 7-1 

bibliography, Preface-iv, 1-2, 2-7, F-l 
Bilinear transform 

equations, Appendix H-7 

example use in design, H-8 

macro, 10-6 
binary constant, 2-7, E-3 
BNF (Backus Naur Form), Appendix D 



boolean 
expressions, 9-9 
operators, 9-9 

BOUNDS, 5-2, B-3 
bounds 
on error, 
maximum re gain, 7-1 to 7-3 
mean square re gain, 7-1 to 7-3 
movement re pole/zero, 7-3 
on gain, 1-3 

invalid specifications, 5-3 
lower, 5-2, 5-3 
upper, 5-2, 5-3 
buffer 
for code, 7-1,8-4, 9-6 
for graphics, 6-3 
Butterworth filter macro, 10-2 
BY, 4-4, B-4 



canonical forms of digital filters, H-3 
carriage-return, 2-2, 3-1, 9-4, F-l 
cascaded stages, 1-4, H-2, H-12, H-14, 

H-15 
change 

commands, 3-2, E-6 

of plane via MOVE, 4-5 

see also l-5ff 
changeable scalars, 2-4, 2-5 
character 

set, 2-2 

strings', 2-3 
charts, Appendix E 
Chebyshev filter 

macro, 1-9, 10-4 

used, 1-10 
CODE, 1-1, 2-5, 7-1, B-2, E-9 
code 

accuracy, 7-4 

and ESC, 7-1 

buffer, 7-1,9-6 

compaction, 1-4, Appendix J 

constraints, 1-4, 7-1 

editing, 1-4, G-l 

for equations, 7-4 

for pole/zero 4 1-3, 7-2 

general signal processing, 1-3, Chapter 1 1 

generation, 1-1, 1-4, 1-5,7-1 

merging, Appendix J 

object, 1-2 

review, 1-4, 7-1 

revision, 1-4, G-l 

submission to 2920 Assembler, 
Appendix G 

using temporary RAM locations, 
Appendix J 
coefficients determine filter behavior, 

H-3ff 

closely approximated in 2920, H-10 
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colon 

in device names, 8-2 

to invoke macros, 9-2, 9-3 
comma, 2-1,2-3, 3-1, 4-2, 5-2, 7-1, 9-4, 9-5 
commands, D-l, E-2 

and tokens, 2-1 

block, 9-1 

code, 7-1, E-9 

change, 3-2, E-6 

compound, 1-5, 9-1 ff 

display, 3-5, E-8 

entry, 3-1 

file, 8-1, E-9 

graph, 6-3, E-9 

line continuation, 2-2, 3-1 

pole/zero, 4-1 to 4-5, E-7 

sequences, 9-1 ff 

simple, 2-4, 3-1 

symmetry, Preface-iv 
comments, 3-1 

in code, 7-1 

into file, 8-4, 9-6 
compaction of code/program, see code 
Compiler 

differences, Preface-iv 

interaction with other products, 
Preface-ii 

introduction, 1-1 

uses and purposes, Preface-iii, 1-1,7-1 
complex 

frequency, 1-1 

network, H-l 

numbers, 1-1 

pole/zero 
defined, 1-3,4-3,4-4 
input/output signal delays, J-2 
realization diagram, H-4 

valued graph, 1-1 

variables, H-l, H-5 
compound commands, 1-5,9-1 to 9-13, D-4 

conditional, 9-11,9-12 

iteration control, 9-8 to 9-10 

macros, 9-1 to 9-7 
Concepts of filter design, 1-1 
conditional 

execution, 9-11 

expression, 9-8 to 9-10 
configuration, Preface-iii 
conjugate 

complex numbers, H-l 

pole pairs, 1-3, 4-3, H-l 
conjunction 

bit-wise integer, see MASK 

logical, see AND 
console, 1-4, 1-5, 2-5, 6-2, 8-2, 8-3, 9-7 
constant 

binary, 2-7, 2-13 

decimal, Preface-v, 2-7, 2-13 

hexadecimal, Preface-vi, 2-7, 2-13 

in coding equations, 1-4,7-1,7-4 

keywords, B-l 

numeric, Preface-vi, 2-7, 2-11, E-3 

suffix, 2-7 

symbolic, 1-3, 1-4,2-6 

system, 2-4, 2-11, E-3 



constraints 

default, 7-2 

on coding, 1-3, 7-lff 

too severe, 7-1, 7-3 
CONTINUOUS, 4-1,4-2, 4-4, 4-5, B-4 
continuous 

filters, 1-1, 4-1, H-5 
compared to digital, H-6 

poles/zeros, 1-3, 4-3, 5-2 
contribution to inaccuracy of time 
responses, 5-4 

s-plane, 1-1, 1-3, 2-4, 4-1, H-6 
controlling a loop, see REPEAT, COUNT 
convolution, H-2 

approximation, 5-4 
coordinates 

as primaries, 2-9, 2-12, E-5 

polar (z-plane), 1-3, 4-1,4-2 

rectangular (S, TS planes), 1-3, 4-1,4-2 
copy 

all I/O to a file, see LIST 

files, F-l 

state or macros from a file, see 
INCLUDE 
corrective actions for error messages, 

Appendix K 
COS, B-l 

COUNT, 9-8, E-10 
CR, carriage return 
create, 

a file, see PUT or APPEND 

objects or symbols, see DEFINE 
cursor controls, 1-4 



dash, 6-3 

dB, decibels, as in GREF 

DC, direct current, as in GREF 

dead band, C-l 

decimal 

constant, 2-7, E-3 

point, Preface-v 
DEFINE command, B-2, E-7 

complete form, E-7 

for macros, 9-2, E-ll 

for poles/zeros, 4-2 

for symbols, 3-3 

see also sample session, l-5ff 
Defining 

a filter, 1-3 

macros, 9-1,9-2, E-ll 

poles or zeros, 1-3, 4-2 

summary chart, E-l 

symbols, 2-6, 3-3 

your own commands, 1-5, 10-1 
definitions for keywords, Appendix B 
delimiter, 2-2 
design, 

filter, 1-1 
review, Appendix H 
device names, 8-2 
digit, Preface-v, 2-2, see constant 
digital 

filtering, H-3 
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filters, canonical forms, H-3 
diagrams, H-4 

signal 
processing, Preface-iv, Appendix H 
digital-to-analog, 1-4, G-l 
D1R MACRO, 9-7, B-2, E-ll 
disjunction 

exclusive, see XOR 

inclusive, see OR 
diskette 

drive, 8-2 

file, 8-2, 8-3, 8-6 
DISPLAY, 8-4, 8-5, B-2 
display 

commands, 3-5, E-8 

from any table, summary chart, E-l 

macros, 9-7, E-ll 

of code, 7-1 

of file, 1-5,8-4 

of filter responses, 1-4 

of object values, 2-4, 3-4 

see also simple sample session, l-5ff 
display text string/expression, with copy to 

List file, see WRITE 
distortion 

correction via HOLD, 5-4 

from output S and H, 5-4 
division 

macro 
definition, 11-2 
invocation, 11-5 

operator, 2-8, 2-9 
documenting a session using 

comments, 3-1, and 

LIST, 8-3 
dollar-sign, 2-2, 2-7 
don't care conditions 

effect on CODE, 5-3 

in bounds, 5-2, 5-3 
double-asterisk 

showing continued input line, 3-1 

("to the power"), 2-8 
doubling the sample rate, 4-1, H-14, H-15 
drivename, 8-1, 8-2 

e, 2-9 
editing 
code after generation, for assembler 

submission, 1-4, G-l 
commands at console, 3-1 
macros, 9-2 
ELSE, 9-11 
EM, 9-2, 9-7 
END, 9-8, 9-11,9-12 
Entering commands, 3-1 
equal sign, 2-5, 3-2, 3-3, 4-2 
Equations, coding, 7-4 
ERROR, 2-5, 7-1, 7-4, B-3, J-3 

default, 7-4 
error 
bounds on gain, 1-4, 7-2 
constraints, 7-1 ff 
ERROR 
MERROR 
MSQE 
PERROR 



messages and corrective actions, 
Appendix K 

on read-only, 3-2 

on undefined or already defined symbol, 
3-3 
Escape key, 1-5, 1-7, 2-2, 7-1, 8-4, 9-4, 9-8, 

F-l 
EVALUATE, 1-8, 3-4, B-2 
execute 

command block 
conditionally, see IF, WHILE, UNTIL 
forever, see REPEAT 
number of times, see COUNT 

commands from a file, see INCLUDE 
EXIT, 1-3, 1-20, 8-2, B-2, F-2 
exit clauses, 9-8 to 9-11, 9-13 
EXP, 2-9, B-l 
exp, expression 
expansion of macro, 9-7 

valid commands in, 9-5 
exponentiation 

limitation, C-l 

number raised to a power, **, 2-8, 2-9 

of natural base e, EXP, 2-9 
expressions, 2-12, 4-2, 4-4, 5-1,6-1,6-2, 

7-1, 8-3,9-9, 9-10, E-5 

arithmetic, 2-8, E-5 

boolean, 9-9 

evaluation, 2-8, 2-9 

integer, 2-8, 4-2, E-5 

logical, 9-9 

relational, 9-8 
extending 

precision, H-12, J-3 

the language, 1-5, 10-1 
extension to filename, 8-2 

FALSE, 9-9, 9-11 

features of the Compiler, Preface-i 
file 
commands, 8-1, E-9 
handling, 8-1 to 8-6 
names, 8-2 

temporary macro, 9-1 
filing and retrieving 1-4, 8-4 to 8-6 
filter 
analog, 5-4, H-l 
continuous, 1-1 
design, 1-1 

commands, D-2 
review, Appendix H 
digital* 1-1, H-l 
examples of advanced techniques, 

Chapter 10 
implementing, 1-1, H-9 
low frequency, H-12 
response functions, 5-4 
response keywords, 5-1 

factors used, 5-4 
responses, 2-12 
sampled, 1-1, l-ll,H-5,H-7 
FIR filters, C-l 
first-order, see stages 
fixed frequency vs. geometry, 4-1 
interaction with sample-rate and 
implementation, 4-1 
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floating point, 2-3, 2-5, 2-7, 2-9, 3-3 

limitations, C-l 
flow of control, 3-1 ; see compound ' 

commands 
formal and actual parameters, 9-3, 9-7, 

10-1 
formulas, Appendix 1 
fraction, Preface-vi, 2-7 
frequency 

and plane and sample-rate, 4-1 

for BOUNDS, 5-2 

forGREF, 5-1 

inFSCALE, 6-1 

range of interest, 1-4,6-1,6-2 

response, 1-4, E-4, Chapter 5 
functions, 2-9 
keywords, 5-1 

scale, 5-3, 6-1 
FSCALE, 1-6, 2-5, 3-3, 5-1 to 5-4, 6-1, 8-4, 

B-3 
full DEFINE and REMOVE, E-7 
functional categories, Preface-iv 
Functions, 2-4, 2-11, B-l,E-4 

of filter response, 5-1 



GAIN, 1-6, 1-7, 5-1,5-4, B-3, 1-3 
gain 

absolute, 5-2 
maximum, 5-2 

characteristic, 1-1 

deviation from bounds when coded, 7-2 

from individual pole, 5-2 

reference, 5-1 
generation 

of code, 1-4,7-1 to 7-4 

of graphs, 6-1 to 6-3 

of listings, 8-3 
geometry 

re frequency, sample rate, and choice of 
plane, 4-1 
GERROR, 5-1,5-3,6-2, B-3, 1-3 
GRAPH, 1-4, 6-2, 6-3, B-2, E-9 
graphable keywords, 5-1 
graph commands, 6-3, E-9 
graphics 

area, 6-2 

buffer, 6-3 

capability, 6-1 

characters, 6-3 

resolution, 6-2, 6-3 
graphs, 1-3, Chapter 6 

see also simple sample session, l-5ff 
GREF, 1-6, 5-1,8-4, B-3, 1-3 

restriction, 5-2 
GROUP, 5-1,5-3,5-4, B-3, 1-4 



hard-copy, Preface-i, 1-4, 6-3 
hardware configuration for SPAC20, 

Preface-ii 
HELP' 

messages, 1-2, 1-5, Appendix A, B-2, 
E-2, F-l 
hertz, 4-1, H-7 



hexadecimal 

fraction with leading zero, 2-7 
number, Preface-vi, 2-7, E-3 

hidden spikes, 5-2, 5-3 

high-frequency 
continuous pole/zero inaccuracies, 5-4 
droop from sample-and-hold, 5-4 

HOLD, 1-18, 2-6, 5-4, 8-4, B-2, 1-4, J-l 

HPI, 2-4, 2-9, B-l 

Hz, hertz, revolutions/cycles per second, 
see also H-7 



identifier, 2-3, 7-1 

filename, 8-2 
IF, 9-11, B-2, E-10 
IIR filters, C-l 
IMAG, 2-9, B-l 

implementing filters with the 2920, 1-4, H-9 
IMPULSE, 2-6, 5-1,5-4, B-3 
Impulse response 

achieved by network, H-5 

analysis, H-2, H-3 
INCLUDE, 1-5, 1-9, 2-6, 8-6, 9-1,9-2, B-2 
input line 

continuation, 3-1 

length, 3-1, F-l 
input/output names for poles/zeros, J-2 
input to assembler, 1-4, Appendix G 
INST, 1-12, 2-5, 7-1, B-3 

default, 7-2 
installation procedure, Appendix F 
integer, 2-5 

expression 2-8, 4-2, 4-3, 9-8, 9-9, E-5 
interactive 

design sessions, 1-1 

manipulation, 1-1 

sample session, 1-5 to 1-20 
interface 

with ISIS-II 8-1, 8-6, Appendix F 
interrogation commands, D-4 
interrupted session restart, 1-4, 8-6 
interrupting any command, see ESCape 
invalid numeric constants, 2-7 
invoking macros, 9-2, E-l 1 
iSBC-310, Preface-iii, iv, F-l, C-l 
ISIS-II, Preface-iii 

installing SPAC20 under, Appendix F 

interface, 8-1 

loading, F-2 
iterative processes, 1-5 

keyboard calculator, 3-4 
Keywords, 2-3, 2-4, Appendix B 

commands, B-2, E-2 

constants, operators, and functions, 
B-l, E-3, E-4 

gain-related, 5-1 

filter response, 5-1 

modifiers, B-4 

objects, B-3 
keyword references, 2-5, 2-6, 2-11, D-2, E-4 



label of pole/zero, 4-2 
language elements, 2-1 
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Laplace transforms 

used in impulse response analysis, H-3 
LBOUND, 5-1 to5-3,B-3 
leading zero, 2-7 
limit 

on characters in identifier, 2-3 

on partitions in 
BOUNDS, B-3 
FSCALE, 6-1 
limit cycles, C-l 
linear, 1-1, H-3 

line-editing characters, 3-1, 3-2 
line-feed, 3-1 

line printer, Preface-ii, 1-2 
LIST, 1-2, 1-5,6-3,8-3, B-2 
listing 

all input/output, 8-3 

help messages, 1-2 

to file, console, printer, 8-2, 8-3 
locating poles and zeros, 4-1 
LOG, 2-4, 2-9, B-l 
logic 

conditional control, 9-1, 9-11, 9-12 
of iterations, 9-8 to 9-10 

operators, 2-3, 9-9 
loop, 9-8 

in macro invocation, 9-3 

using compound commands, 9-8 to 9-10, 
9-13, E-10 
low frequencies, 1-3, H-12 
:LP:, 1-2,8-2 



MACRO, 8-4, 9-7, B-3, E-ll 
macro 
body, 9-1 

command functions, 9-1 
defining, 9-2 
directory, 9-7 
displaying, 9-7 
editing, 8-6, 9-2 
error checking, 10-1 
expansion, 9-7, 9-8, 1 1-4 
file, 9-1 
in loop, 9-8 

invoking, 2-3,9-1,9-2, 11-4 
library, 8-6 

models, 9-2 to 9-6, Chapters 10 and 1 1 
names, 9-2, 9-7 
parameters, 2-3, 9-1, 9-3 
removing, 9-7 
strings in, 9-4 
syntax checking, 9-1 , 9-7 
usage, 1-3, Chapters 10, 11 
used under SUBMIT, 8-6 
macros, Preface-iii, 9-1, Chapters 9-11, 
D-5,E-11 
filter, see 

All-pole coding 

Bilinear 

Butterworth 

Chebyshev 
other signal processing, see 

A-to-D conversion 

division 



multiplication 
sawtooth 
sinusoid 
traingular 

supplied-file, F-l 
MAGAIN, 2-5, 5-1, 5-2, 6-2, B-3, 1-3, J-l 

hidden spikes, 5-2 
manuals 

reference, Preface-iv, 1-2, 2-7, F-l 
mapping to Z plane, 1-3, H-6, H-7 
MASK, 2-8, 2-9, B-l 
matched-z transform, 4-1 , 4-5, H-6 
math board, see iSBC 
maximum 

absolute gain, 5-2 

gain error, 5-3 
mean-square-error, 1-4, 5-3, 7-1 to 7-3 
merging code for poles and zeros, 

Appendix J 
MERROR, 2-5, 5-1 , 5-3, 6-2, 7-1 to 7-3, 

B-3 
minima and error constraints, 7-1 , 7-4 
minus, 2-3, 2-8, 2-9 
MOD, 2-8, 2-9, B-l 
modifiers, 2-4, B-4 
modules of code, 1-4 
MOVE, 4-4, B-2, E-7 

see also l-5ff 
movement of poles or zeros 

as a constraint on coding, 7-1 , 7-3 

by command, 1-3, 4-4 

due to approximate coding, 7-1 , 7-3 
MSQE, 2-5, 5-1, 5-3, 6-2, 7-1 to 7-3, B-4, 

1-3 
multiplication 

conversion into 2920 ADDs and SUBs, 
H-10 

macro 
definition, 11-1 
invocation, 1 1-4 

operator, 2-8, 2-9 
multiplier, 7-1, 7-4, see also constant 

in digital filter block diagram, H-3ff 



Names 

device, 8-2 

file, 8-2 

ISIS-II, 8-2, F-l 

of signal values in code, 1-14,7-1, 10-12, 
10-14, 10-15, 11-8, 11-10 

see also keywords, Appendix B 

symbolic, 1-4,2-3,2-6,7-1 

system constants, E-3 

user, 2-2, 2-6 
natural base e, 2-9 
nesting compound commands, 9-12 
non-scalars, 2-5 
non-changeable scalars, 2-4 
normalization, 1-2, 5-1, 5-4, 1-1 
NOT, 9-9, B-l 
Notation, Pref'ace-v 
Notes and Cautions, Appendix C 
number, 2-7 

complex, 1-1, H-lff 
numeric constant, 2-7, E-3 
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object 
keywords, Preface-vii, Appendix B-3 

object code, 1-2, G-l 

OFF, 5-4, B-5 

OGRAPH, 1-7, 6-2, 6-3, B-2, E-9 

omitted parameters 
in macro body (formal), 9-5 
in macro call (actual), 9-4, 9-6 

ON, 2-6, 5-4, B-5 

operands, 2-9 

operational amplifier, H-2 

operators, 2-8, B-l 

OR, 9-9, B-l 

OR1F, 9-11, B-5 

overflow, 7-4, C-l, H- 11, J- 1 

overwrite, 8-5 



precision, 

extended, H-12, J-3 

single, 2-7 
precedence of operators, 2-8, 2-9 
primaries, 2-8 to 2-10, 7-1 , E-6 
printer, Preface-i, 1-4, 8-2 
prompt character 

ISIS-II, 8-1 

SPAC20, 1-2 

within macros or compound commands, 
9-1 
propagation, 1-3, 1-4, 7-1, Appendix J 

of carry, H-12 
PUT, 1-3, 1-12, 2-6, 7-3, 8-5, 8-6, 9-1, B-3 

default objects, 8-4 
PZ, 1-6, 4-3,4-4, B-4 



parallel-structured filter stages, H-14, H-15 
parameters 

design, 1-1,7-1 

file, 1-5 

macro: formal, actual, 8-6, 9-3 
parentheses, 2-2, 2-8 to 2-10 
partial fractions in impulse response, H-2 
partial results, 1-5 
partition 

of poles/zeros, 2-10, 4-3, 4-4, E-6 
interpreted sequentially, 4-2 

on scales for graphs, 6-1 ff 
pathname, 8-2, 8-6 
percent 

sign use in macros, 9-3 

used on YSCALE, 6-2 
period, 2-2, 2-3, 2-6, 3-2, 6-3, 9-1,9-8 
PERROR, 1-13, 7-1, 7-2, B-4, J-3 
PHASE, 1-8, 5-1, 5-3, 5-4, B-4, 1-3 
phase 

and group delay, 5-3 

desired output, 1-1 
PI, 1-8, 2-4, 2-9, 4-2, B-l 
piecewise linear, 1-4 
Planes 

and coordinates, 4-1 , 4-2 

changing via MOVE, 4-5 
plot 

last curve again, GRAPH 

new curve over last, OGRAPH 

screen size, see XSIZE 
plus signs, 2-2, 2-8, 2-9 

in graphs, 1-7, 6-3 
POLE, 3-5, 4-2 to 4-4, 7-1, B-4 
pole 

coordinates, 4-1 

creation or destruction via MOVE, 4-4 

definition, 1-1, 4-2 

duplication, 4-4 

error, 7-2, 7-3 

location, 1-1 

maximum number of, 4-2 

moving, 4-4 

numbering, 4-3 

of transfer characteristic, H-l 

real, 4-3 

removing, 4-3 
practical consideration, H-ll 



quadratic terms, H-l 
correspond to complex conjugate pole 
pairs, H-2 
question mark, 2-2 
quote, 2-2, 2-3, 9-4, 9-5 

radians, 2-9, 4-1,4-2, 5-3 
RADIUS, 2-9, B-l 

non-negative only, 4-2 
range 

of frequencies or time, see scales 

of pole/zeros, see partition 
read-only, 2-4, 2-5, 3-2, 5-2 
REAL 2-9, B-l 
real pole/zero 

defined, 4-3 

input/output signal delays, J-2 

permit "real" components, H-l 

realization diagram, H-4 
redisplay, 1-4, 6-3 
relational 

expressions 9-8, 9-9 

symbols 2-2, 2-3,9-8 
remainder, see MOD 
REMOVE command, B-3, E-7 

complete form, E-7 

for macros, 9-7, E-l 1 

for poles/zeros, Preface-v, 1-3,4-3 

for symbols 3-4 

message, 4-3 

see also simple sample session, 1 -5 f f 
removing objects 

summary chart, E-l 
RENAME, F-l 
REPEAT, 9-8, B-3, E-10 
resolution, 6-2, 6-3 
restart of session, 1-5, 2-6 
Retrieving 

files of code or parametes, see 

INCLUDE 
review of analog filters, Appendix H 

S, H-l 

S & H, sample-and-hold 
sampled 

filters, 1-11, H-5,H-7 

pole/zero, 2-6, 4-1 

signals, H-3 
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sampling 

interval TS, 1-3, 2-5, 6-1, H-8 

limitations, H-5 

rate, 1-3, 1-11,4-1,5-4, H-12, H-14, 
saturation, H-l 1 

shown by asterisk, 6-2 
saving partial results, 1-3, 1-4 
sawtooth waveform macro 

definition, 1 1-2 

invocation, 1 1-7 
scalar keywords, 2-4, 2-5 
Scales, 5-1,6-1 

changes, 6-3 

frequency, 6-1 

time, 6-1 

vertical, 6-2 
scaling, 1-3, 1-4,5-2,5-4,7-1 

and other considerations, H-l 1, 
Appendix J, 
screen 

size, 6-1 ff 
second-order (quadratic), H-l, H-2, 

H-5, see also stages 
semicolon, 2-2, 3-1, F-l 
separator, 3-1 
sequence of use, 1-3 
set commands, 3-2, E-6 
show contents of a file, see DISPLAY 
signal propagation, Appendix J 
sign-on messages, 8-1, F-l 
simple sample session, 1-5 to 1-20 
Simulator, 1-2, G-l 
SIN, 2-9, B-l 
single precision, 2-7 
sinusoid waveform 

in complex network analysis, H-l, 
H-4, H-5 

macros 
at user-specified frequency 
definition, 1 1-4 
invocation, 11-9 
from triangular waveform 
definition, 1 1-4 
invocation, 11-8 
slash, 2-2, 2-8, 2-9 
software installation, Appendix F 
SPAC20 files, F-l 
space, 2-2, 2-6, 3-1 
special-character usage, 2-2 

sequences as tokens, 2-3 
S-plane, 1-1, 1-3,2-9,4-1, H-6 
SQR,2-9, B-l 
stages, 1-3, 5-4,7-1, J-l 

first and second order cascaded, 1-4, 
H-2, H-14, H-15 

in parallel, H-16 
STEP, 2-6, 5-1,5-4, B-4 
strings, 2-2, 2-3, 8-3, 8-4, 9-4 
submission 

of code to Assembler, 1-5, 
Appendix G 

of command to Compiler, 3-1 
SUBMIT, 3-1,8-6 
suffix see constant, Preface-v, 2-7 
superimpose graphs, 1-4,6-3 



symbolic 

constants, 1-3 

names, 1-4, 2-3, 2-6, 7-1 

references, 2-6, 2-11, 3-2, E-4 

variables, 1-4, 2-6 
SYMBOLS, 3-4, 8-4, B-4 
symbol table, 2-6, 3-3 
symmetry of command syntax, 

Preface-iv 
syntax 

charts, Preface-v, Appendix E 

checking in macros, 9-7 

description in BNF, Appendix D 

errors, 9-1,9-13, K-l 
system constant, E-3 



tables 

macros, 9-2 

pole/zero, 4-1 

symbols, 2-6, 3-3 
TAN, B-l 
temporary RAM used in coding equations, 

Appendix J 
terminating 

a command, 3-1 

aline, 3-2 

a macro, 9-2, 9-4, 9-8 

an interactive session, 8-2 
THEN, 9-11, B-5 
THROUGH, 2-10, 4-3, B-5 
time 

response, 5-4, 6-1, E-4 

scale, 6-1, 6-2 
TO, 4-4, 4-5, B-5 
Token, 2-1,2-3,3-1 

partial, 9-3 

predefined, 2-4 
TPI, 3-4, B-2 
transfer 

function, 1-1 
factors, 1-1 

characteristic, H-l 
transforms, Preface-v, Appendix H 

Bilinear, 10-6, H-7 to H-9 

impulse invariant, H-5, H-6 

matched-Z, H-6 
triangular waveform macro 

definition, 11-3 

invocation, 11-8 
TRUE, 9-9, 9-11 
TS, 1-3, 1-11,2-1,2-2,2-5,2-6,4-1,4-4, 

5-1,5-4,6-1,6-2, B-4, H-14 

consequences, 4-1 



UBOUND, 3-3,5-1 to 5-3, B-4 
underflow, C-l, H-l 1 
underline, 2-2 

upper and lower bounds, 5-2 
unit delay, H-9 

realization in 2920, H-10 
UNTIL, 9-8 to 9-10, B-5, E-10 
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impulse, 5-4 

step, 5-4 
user names, 2-2, 2-6, 3-2 
utility commands, D-4 

variable 
independent, computing of, 1-4 
names, 1-4, 2-6, 7-1 

WHILE, 9-8 to 9-10, B-5, E-10 

WRITE, 8-3, B-3 

write over a file, see PUT 

XOR, 9-9, B-2 

XSIZE, 2-5, 3-3, 5-1, 5-4, 6-1 to 6-3, 8-4, 
B-4 

YSCALE, 1-8, 6-2, 8-4, B-4, C-l 
YSIZE, 2-5, 3-3, 6-2, 6-3, 8-4, B-4 



Z, 4-2, 4-4, B-5 

ZERO, 3-5, 4-2 to 4-4, 7-1 , B-4 

zero 

coordinates, 4-1 

creation or destruction via MOVE, 4-4 

definition, 1-1, 4-2 

duplication, 4-4 

error, 7-2, 7-3 

location, 1-1 

maximum number of, 4-2 

moving, 4-4 

numbering, 4-3 

of transfer characteristic, H-l 

real, 4-3 

realization, H-2 

removing, 4-3 
Z plane, 1-1, 1-3,2-6, 2-9, 4-1, H-6 
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